'''`[array] unset`''' unsets variables in an array.



** Synopsis **

'''`[array] unset`''' ''`arrayName ?pattern?`''



** Description **

Unsets all of the variables in the array that match ''`pattern`'' (using the matching rules of '''`[string match]`'''). If ''`arrayName`'' isn't the name of an array variable or there are no matching variables in the array, no error will be raised. If ''`pattern`'' is omitted and ''`arrayName`'' is an array variable, then the command unsets the entire array. The command always returns an empty string.

Note that this is only available from Tcl v8.3 onwards; see [Arrays / Hash Maps] for methods of clearing arrays in earlier versions of Tcl.

----

[Bezoar]:

Because it is prevalent in the sqlite api for tcl it may become necessary to unset an array index that is literally "*". Use normal [string match] escaping, such as one of these forms: 
 
======
array unset  x \[*\]
array unset  x {[*]}
array unset  x \\*
array unset  x {\*}
======



<<categories>> Command | Tcl syntax help