1mNAME0m
       unset - Delete variables

1mSYNOPSIS0m
       1munset 22m?4m-nocomplain24m? ?4m--24m? ?4mname24m 4mname24m 4mname24m 4m...24m?


1mDESCRIPTION0m
       This  command  removes  one or more variables.  Each 4mname24m is a variable
       name, specified in any of the ways acceptable to the 1mset 22mcommand.  If a
       4mname24m  refers  to  an  element  of an array then that element is removed
       without affecting the rest of the array.  If  a  4mname24m  consists  of  an
       array  name  with  no  parenthesized  index,  then  the entire array is
       deleted.  The 1munset 22mcommand returns an  empty  string  as  result.   If
       4m-nocomplain24m is specified as the first argument, any possible errors are
       suppressed.  The option may not be  abbreviated,  in  order  to  disam-
       biguate  it  from possible variable names.  The option 4m--24m indicates the
       end of the options, and should be used if you wish to remove a variable
       with  the  same  name  as  any of the options.  If an error occurs, any
       variables after the named one causing the error not deleted.  An  error
       can  occur when the named variable doesn't exist, or the name refers to
       an array element but the variable is a scalar, or the name refers to  a
       variable in a non-existent namespace.

1mEXAMPLE0m
       Create an array containing a mapping from some numbers to their squares
       and remove the array elements for non-prime numbers:
              array set squares {
                  1 1    6 36
                  2 4    7 49
                  3 9    8 64
                  4 16   9 81
                  5 25  10 100
              }

              puts "The squares are:"
              parray squares

              1munset 22msquares(1) squares(4) squares(6)
              1munset 22msquares(8) squares(9) squares(10)

              puts "The prime squares are:"
              parray squares


1mSEE ALSO0m
       set(n), trace(n), upvar(n)


1mKEYWORDS0m
