DeleteCollection

DeleteCollection

DeleteCollection(ALL), DeleteCollection(TRANS), DeleteCollection(NONE), DeleteCollection

parameters: ALL, TRANS, NONE

Stack

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

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.