| **Navigation:**  [[templates.htm|Templates]] > [[tlrcontents.htm|Template Language Reference]] > Complete Alpha Listing >====== #DELETE (delete a multi-valued symbol instance) {{c6h0068.jpg|C6H0068.jpg}} ====== | [[ define  user defined macro .htm|{{btn_prev_n.gif|Previous page}}]][[tlrcontents.htm|{{btn_home_n.gif|Return to chapter overview}}]][[ deleteall  delete multiple multi valued symbol instances .htm|{{btn_next_n.gif|Next page}}]] |
|  ||

**#DELETE(** //symbol [//, //position// ] **)**

{{blk2blue.jpg|blk2blue.jpg}}

| **#DELETE** | Deletes the value from one instance of a multi-valued user-defined symbol. |
| //symbol// | A multi-valued user-defined symbol. |
| //position// | An integer constant or symbol containing the instance number in the //symbol//. Instance numbering begins with one (1). If omitted, the default is the current fixed instance. |

The **#DELETE** statement deletes the value from one instance of a multi-valued user-defined symbol. If there are any symbols dependent upon the //symbol//, they are also cleared. If this is the last instance in the //symbol//, the instance is removed. You can get the current instance number to which a symbol is fiXEd by using the **INSTANCE(%symbol)** built-in template procedure.

**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,'QUE')        #!Add a value**

**#!%ProcFilesPrefix contains: SAV, BAK, PRE, QUE**

**#DELETE****(%ProcFilesPrefix,1)         #!Delete first value (SAV)**

**#!%ProcFilesPrefix contains: BAK, PRE, QUE**

**#FIX(%ProcFilesPrefix,'PRE')        #!Fix to a value**

**#DELETE****(%ProcFilesPrefix)           #!Delete it**

**#!%ProcFilesPrefix contains: BAK, QUE**

**See Also:     **[[ declare  declare a user defined symbol .htm|#DECLARE]] ,[[ add  add to multi valued symbol .htm|#ADD]]