distrib/share/tcl/help/tcl/strings/append

   1 NAME
   2        append - Append to variable
   3
   4 SYNOPSIS
   5        append varName ?value value value ...?
   6
   7
   8 DESCRIPTION
   9        Append all of the value arguments to the current value of variable var-
  10        Name.  If varName doesn't exist, it is given a value equal to the  con-
  11        catenation  of  all the value arguments.  The result of this command is
  12        the new value stored in variable varName.   This  command  provides  an
  13        efficient  way  to build up long variables incrementally.  For example,
  14        ``append a $b'' is much more efficient than ``set a  $a$b''  if  $a  is
  15        long.
  16
  17 EXAMPLE
  18        Building a string of comma-separated numbers piecemeal using a loop.
  19               set var 0
  20               for {set i 1} {$i<=10} {incr i} {
  21                  append var "," $i
  22               }
  23               puts $var
  24               # Prints 0,1,2,3,4,5,6,7,8,9,10
  25
  26
  27 SEE ALSO
  28        concat(n), lappend(n)
  29
  30
  31 KEYWORDS