The IDL_Container::Remove procedure method removes an item from the container.
Syntax
Obj->[IDL_Container::]Remove [, Heapvar] [, POSITION=index] [, /ALL]
Arguments
Heapvar
A scalar or array of heap variables (object references or pointers) to be removed. If Heapvar is not provided (and neither the ALL nor POSITION keyword are set), the first item in the container will be removed. If Heapvar is !NULL then nothing is removed and the method quietly returns.
Keywords
ALL
Set this keyword to remove all items from the container. If this keyword is set, the Heapvar argument is not required.
POSITION
Set this keyword equal to the zero-based index of the item to be removed. If theHeapvar argument is supplied, this keyword is ignored.
Version History
5.0 |
Introduced |
8.2 |
Allow !NULL as an input argument
|
8.4 |
Add support for pointers within containers |
See Also
IDL_Container::Add, IDL_Container::Count, IDL_Container::Equals, IDL_Container::Get, IDL_Container::IsContained, IDL_Container::Move