| **Navigation:**  [[introduction.htm|Language Reference]] > 13 - Built-in Functions >====== UNTIE(disassociate a string value from an ASTRING) ====== | [[unregister  unregister event handler .htm|{{btn_prev_n.gif|Previous page}}]][[introduction.htm|{{btn_home_n.gif|Return to chapter overview}}]][[update  write from screen to use variables .htm|{{btn_next_n.gif|Next page}}]] |
|  ||

**UNTIE(**[//stringtoken//],[//index]//**)**

{{blk2blue.jpg|blk2blue.jpg}}

| **UNTIE** | Removes a value previously TIED for an ASTRING. |
| //stringtoken// | The label of a previously declared ASTRING token. If omitted, all previously declared ASTRINGs are used. |
| //index// | A numeric constant or variable defining the index value of a previously declared ASTRING. The index value may be any LONG value greater than zero. If omitted, all indexes are used. |

The **UNTIE** statement disassociates a string value that was previously associated to a particular ASTRING// stringtoken //and //index//.

**Example:**

**   PROGRAM**

**    MAP**

**    END**

**          **

** INCLUDE('EQUATES.CLW')**

** COLOR   EQUATE(1)**

** SIDES   EQUATE(2)**

** AS1     ASTRING**

** CODE**

** AS1 = 'SHAPE'                  !Declare ASTRING string token**

** TIE('SHAPE',COLOR,COLOR:RED)   !Associate COLOR:RED to COLOR for ASTRING SHAPE**

** TIE(AS1,SIDES,3)               !Associate 3 to SIDES for ASTRING SHAPE**

** (some code here)**

** ****UNTIE****(AS1, SIDES)**

**See Also:**

[[tie associate a string value to an astring .htm|TIE]]

[[tied retrieves a value associated with an astring.htm|TIED]]