#FREE (free a multi-valued symbol) 

Top  Previous  Next

 

#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

 

See Also:     #DECLARE ,#ADD ,#CLEAR