|
The
api_pidremove function removes the persistent ID from a given entity, provided one exists. No attempt is made to reuse this persistent ID for a subsequent entity. For example, refer to the following sequence of function calls:
|
|
|
1.
|
api_pidset(A)
|
|
|
Entity
A is given a persistent ID; this ID is associated with index 1.
|
|
|
2.
|
api_pidremove(A)
|
|
|
Entity
A has no persistent ID (so, no index).
|
|
|
3.
|
api_pidset(B)
|
|
|
Entity
B is given a persistent ID with index 2 (the ID associated with index 1 is not reused).
|
|
|
4.
|
api_pidset(A)
|
|
|
Entity
A is given a persistent ID with index 3 (the ID associated with index 1 is not reused).
|