global - Access global variables
global ?varname ...?
global(1t) Tcl Built-In Commands global(1t)
______________________________________________________________________________
NAME
global - Access global variables
SYNOPSIS
global ?varname ...?
______________________________________________________________________________
DESCRIPTION
This command has no effect unless executed in the context of a proc
body. If the global command is executed in the context of a proc body,
it creates local variables linked to the corresponding global variables
(though these linked variables, like those created by upvar, are not
included in the list returned by info locals).
If varname contains namespace qualifiers, the local variable's name is
the unqualified name of the global variable, as determined by the
namespace tail command.
varname is always treated as the name of a variable, not an array ele-
ment. An error is returned if the name looks like an array element,
such as a(b).
EXAMPLES
This procedure sets the namespace variable ::a::x
proc reset {} {
global a::x
set x 0
}
This procedure accumulates the strings passed to it in a global buffer,
separated by newlines. It is useful for situations when you want to
build a message piece-by-piece (as if with puts) but send that full
message in a single piece (e.g. over a connection opened with socket or
as part of a counted HTTP response).
proc accum {string} {
global accumulator
append accumulator $string \n
}
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+------------------+
|Availability | runtime/tcl-8 |
+---------------+------------------+
|Stability | Uncommitted |
+---------------+------------------+
SEE ALSO
namespace(n), upvar(n), variable(n)
KEYWORDS
global, namespace, procedure, variable
NOTES
Source code for open source software components in Oracle Solaris can
be found at https://www.oracle.com/downloads/opensource/solaris-source-
code-downloads.html.
This software was built from source available at
https://github.com/oracle/solaris-userland. The original community
source was downloaded from http://prdownloads.sourceforge.net/tcl/tcl-
core8.6.7-src.tar.gz.
Further information about this software can be found on the open source
community website at https://www.tcl.tk/.
Tcl global(1t)