Navigation: Templates > Template Language Reference > Complete Alpha Listing >====== #PURGE (delete all single or multi-valued symbol instances) ====== | |
#PURGE( symbol )
#PURGE | Deletes the values from all instances of a user-defined symbol. |
symbol | A user-defined symbol. |
The #PURGE statement deletes all values from the symbol. If there are any symbols dependent upon the symbol, they are also cleared. If the symbol is dependent upon a multi-valued symbol, all instances of that dependent symbol are purged for all instances of the symbol upon which it is dependent.
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
#PURGE(%ProcFilesPrefix) #!Delete all instances