This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

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



____________________________________________________________________________________________________________

NAME
       lappend - Append list elements onto a variable

SYNOPSIS
       lappend varName ?value value value ...?
____________________________________________________________________________________________________________


DESCRIPTION
       This  command  treats the variable given by varName as a list and appends each of the value arguments
       to that list as a separate element, with spaces between elements.  If varName doesn't  exist,  it  is
       created  as  a  list with elements given by the value arguments.  Lappend is similar to append except
       that the values are appended as list elements rather than raw text.  This command  provides  a  rela-tively relatively
       tively  efficient  way to build up large lists.  For example, ``lappend a $b'' is much more efficient
       than ``set a [concat $a [list $b]]'' when $a is long.


SEE ALSO
       list(n), lindex(n), linsert(n), llength(n), lset(n) lsort(n), lrange(n)                               |


KEYWORDS
       append, element, list, variable



Tcl                                                                                               lappend(n)