Manual Pages for UNIX Operating System command usage for man lappend

Tcl Built-In Commands                                 lappend(1T)



_________________________________________________________________

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 relatively 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.

EXAMPLE
     Using lappend to build up a list of numbers.
          % set var 1
          1
          % lappend var 2
          1 2
          % lappend var 3 4 5
          1 2 3 4 5


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


KEYWORDS
     append, element, list, variable

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:












Tcl                       Last change:                          1






Tcl Built-In Commands                                 lappend(1T)



     _______________________________________
    |   ATTRIBUTE TYPE   |  ATTRIBUTE VALUE|
    |____________________|__________________|_
    | Availability       |  runtime/tcl-8  |
    |____________________|__________________|_
    | Interface Stability|  Uncommitted    |
    |____________________|_________________|

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













































Tcl                       Last change:                          2