append(n) [osx man page]

append(n)						       Tcl Built-In Commands							 append(n)

__________________________________________________________________________________________________________________________________________________

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 does not 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(n), lappend(n)

KEYWORDS

       append, variable

Tcl																	 append(n)

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

__________________________________________________________________________________________________________________________________________________

NAME

       eval - Evaluate a Tcl script

SYNOPSIS

       eval arg ?arg ...?
_________________________________________________________________

DESCRIPTION

       Eval  takes  one  or more arguments, which together comprise a Tcl script containing one or more commands.  Eval concatenates all its argu-
       ments in the same fashion as the concat command, passes the concatenated string to the Tcl interpreter recursively, and returns the  result
       of  that  evaluation  (or any error generated by it).  Note that the list command quotes sequences of words in such a way that they are not
       further expanded by the eval command.

EXAMPLE

       This procedure acts in a way that is analogous to the lappend command, except it inserts the argument values at the start of  the  list	in
       the variable:
	      proc lprepend {varName args} {
		 upvar 1 $varName var
		 # Ensure that the variable exists and contains a list
		 lappend var
		 # Now we insert all the arguments in one go
		 set var [eval [list linsert $var 0] $args]
	      }

KEYWORDS

       concatenate, evaluate, script

SEE ALSO

       catch(1T), concat(1T), error(1T), list(1T), subst(1T), tclvars(1T)

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																	  eval(1T)