A '''level''' is a [command] evaluation context.



** Description **

For the evaluation of most commands, a new level is created and the command
evaluated at that level. A level maintains the following four notions:

       The current [namespace]:   

       The current variable table:   For most commands, the current variable table is the local variable table that exists only for the duration of the command, and is only accessible to commands in scripts evaluated at the current level.  For a few commands such as `[namespace eval]` the variable table of the current namespace is the current variable table.

       The current command:   

       The sequence of previous levels:   

A level could be called a [stack frame], but that term used when discussing
constructs in the implementation of Tcl, while ''level'' is used to discuss the
behaviour of a Tcl interpreter.



** Commands Related to Levels **

Some commands manipulate the current level or reference resources at other
levels.  Here is a brief description of such commands:

   [info level]:   Provides information about the current and previous levels.

   [namespace eval]:   Creates a new level, associates that level with the indicated namespace, and evaluates a script at that level.

   [proc]:   Arranges for a level to be created, arguments to the command to be assigned in the current variable table, and for the body of the procedure to be evaluated at the new level.

   [set]:   Modifies the current variable table.  At a level associated with a namespace if the specified variable doesn't exist at that level, but does exist at the [global] level, modifies the global variable table instead.  This behaviour is now considered a mistake to be fixed in some future version of Tcl.

   [uplevel]:   Arranges for a [script] to be evaluated at some level, which is resolved relative to the current level. 

   [upvar] and [namespace upvar]:   Each of these commands modifies a variable table, which is resolved relative to the current level.

   [variable]:   Modifies the variable table of the current level.



** See Also **

   [Many ways to eval]:   Whenever a script is evaluated, a level is involved.

   [downlevel]:   An [Eagle]-only extension to [uplevel].

<<categories>> glossary