append(1T)						       Tcl Built-In Commands							append(1T)

__________________________________________________________________________________________________________________________________________________

NAME

       append - Append to variable

SYNOPSIS

       append varName ?value value value ...?
_________________________________________________________________

DESCRIPTION

       Append  all  of	the  value arguments to the current value of variable varName.	If varName doesn't exist, it is given a value equal to the
       concatenation of all the value arguments.  The result of this command is the new value stored in variable varName.  This  command  provides
       an  efficient  way to build up long variables incrementally.  For example, ``append a $b'' is much more efficient than ``set a $a$b'' if $a
       is long.

EXAMPLE

       Building a string of comma-separated numbers piecemeal using a loop.
	      set var 0
	      for {set i 1} {$i<=10} {incr i} {
		 append var "," $i
	      }
	      puts $var
	      # Prints 0,1,2,3,4,5,6,7,8,9,10

SEE ALSO

       concat(1T), lappend(1T)

KEYWORDS

       append, variable

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWTcl	      |
       +--------------------+-----------------+
       |Interface Stability | Uncommitted     |
       +--------------------+-----------------+
NOTES

       Source for Tcl is available on http://opensolaris.org.

Tcl																	append(1T)