Navigation: Templates > Template Language Reference > Complete Alpha Listing >====== #FREE (free a multi-valued symbol)  ====== |    |
#FREE( symbol )
| #FREE | Clears all instances of a multi-valued user-defined symbol. |
| symbol | A multi-valued user-defined symbol. |
The #FREE statement clears all instances of a multi-valued user-defined symbol. If there are any symbols dependent upon the symbol, they are also cleared.
Example:
#DECLARE(%ProcFilesPrefix),MULTI #!Declare multi-valued symbol
#ADD(%ProcFilesPrefix,'SAV') #!Add a value
#ADD(%ProcFilesPrefix,'BAK') #!Add a value
#ADD(%ProcFilesPrefix,'PRE') #!Add a value
#ADD(%ProcFilesPrefix,'BAK') #!Add a value
#ADD(%ProcFilesPrefix,'QUE') #!Add a value
#!%ProcFilesPrefix contains: SAV, BAK, PRE, BAK, QUE
#DELETEALL(%ProcFilesPrefix,'BAK') #!Delete all BAK instances
#!%ProcFilesPrefix now contains: SAV, PRE, QUE
#FREE(%ProcFilesPrefix) #!Free the symbol
#!%ProcFilesPrefix now contains nothing