Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

global (1t)

Name

global - Access global variables

Synopsis

global ?varname ...?

Description

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
       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)