Version 11 of unset

Updated 2013-05-29 22:24:58 by pooryorick

Summary

Removes one or more variables.

unset ?-nocomplain? varName ?varName ...?
official reference

It is an error for the variables to not already exist, the name to be illegal, etc. This error can be suppressed with the -nocomplain option. etc. This error can be suppressed with the -nocomplain option. A trace on the variable can resurrect it. A [trace] on the variable might resurrect it. DKF: In 8.6, unset is bytecode compiled. (And don't use catch DKF: In 8.6, [unset] is bytecode compiled. (And don't use [catch {unset foo}]; the operationally-equivalent [unset -nocomplain foo`]


In retrospect, unset should have been designed so that it was not an error to

Misc

Erik Leunissen on comp.lang.tcl 2002-10:

    Well, I've been bitten by this one on a *regular* basis, but not on a
    *frequent* basis. So infrequently, that I tend to forget about the issue, and
    once it happens again, it takes me by surprise and I need hours to find the
    cause of evil, which I'll explain:
    
    The following happens when you bind a variable to an entry widget 
    through the -textvariable option and subsequently issue [unset 
    textvariable] :
    
       1. the textvariable may become unset for a fraction of a millisecond, I'm not sure. Perhaps somebody else can elaborate on this ...
       2. the textvariable binding will immediately reassign the value of the contents of the entry widget to the textvariable. (If it has been unset for a short moment, it is recreated)
    
    So what's the recipe then?
    
       1. release the binding to the entry widget by:
       ** doing [.entry -textvariable {}], or
       ** destroying the widget entirely
       2. unset the variable: [unset textvariable]
       3. try to remember this issue (better than I do) when it takes you by surprise the next time.

For the coming releases of Tcl (still in CVS), you can also set an unset trace
on the textvariable, and let the trace handler do the above step one and/or
two. For current releases this will not yet work because of a (recently fixed)
bug.

proc test {n cmd} {

unset , a [Tcl