#PURGE (delete all single or multi-valued symbol instances) 

Top  Previous  Next

 

#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

 

See Also:     #DECLARE ,#ADD