Copyright (c) 1993 The Regents of the University of California.
Copyright (c) 1994-1997 Sun Microsystems, Inc.

See the file "license.terms" for information on usage and redistribution
of this file, and for a DISCLAIMER OF ALL WARRANTIES.

RCS: @(#) $Id: global.n,v 1.4.2.1 2004/10/27 12:52:40 dkf Exp $

.so man.macros S Note: do not modify the .SH NAME line immediately below!
global - Access global variables global varname ?varname ...? E

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.

This procedure sets the namespace variable ::a::x .CS proc reset {} { global a::x set x 0 } .CE

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). .CS proc accum {string} { global accumulator append accumulator $string \\n } .CE

namespace(n), upvar(n), variable(n) global, namespace, procedure, variable