| **Navigation:**  [[templates.htm|Templates]] > [[tlrcontents.htm|Template Language Reference]] > Complete Alpha Listing >====== #PURGE (delete all single or multi-valued symbol instances) {{c6h0068.jpg|C6H0068.jpg}} ====== | [[ prototype  procedure prototype .htm|{{btn_prev_n.gif|Previous page}}]][[tlrcontents.htm|{{btn_home_n.gif|Return to chapter overview}}]][[ query  conditionally generate source .htm|{{btn_next_n.gif|Next page}}]] |
|  ||

**#PURGE(** //symbol //**)**

{{blk2blue.jpg|blk2blue.jpg}}

| **#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  declare a user defined symbol .htm|#DECLARE]] ,[[ add  add to multi valued symbol .htm|#ADD]]