DeleteCollection
DeleteCollection(ALL), DeleteCollection(TRANS), DeleteCollection(NONE), DeleteCollection
parameters: ALL, TRANS, NONE
Stack | Position | Description |
---|---|---|
Stack(In) | Top | a collection |
Stack(Out) | Top | - |
With this statement a collection can be explicitly (physically!) deleted. The parameter controls what should happen to the elements found in the collection:
Parameters | Description |
---|---|
ALL | delete all elements |
TRANS | delete only transient elements |
- / NONE | Elements remain unchanged |
If elements are deleted, this corresponds exactly to the operation triggered by the DeleteObject command: transient objects are physically deleted, but persistent ones only logically!
Note: Transient collections that are no longer in use will automatically remove the garbage collection, but not its elements.