Erase statement (LotusScript® Language)
Deletes an array, list, or list element.
Syntax
Erase { arrayName | listName | listName ( tag ) } [, { arrayName | listName | listName ( tag ) } ]...
Elements
arrayName
An array or a Variant variable containing an array. arrayName can end with empty parentheses.
listName
A list or a Variant variable containing a list. listName can end with empty parentheses.
tag
The list tag of a list element to be erased from the specified list.
Usage
The following table shows how the Erase statement affects arrays and lists.
Item |
Effect of Erase statement |
---|---|
Fixed array |
Its elements are reinitialized. |
Dynamic array |
LotusScript® removes all elements from storage and recovers the storage. The array retains its type, but has no elements. You must use ReDim to redeclare the array before referring to its elements again. If you used ReDim before it was erased, the array maintains the same number of dimensions. |
List |
LotusScript® removes all elements from storage and recovers the storage. The list retains its type, but has no elements. |
List element |
The element no longer exists in the list. |