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

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












Tcl                       Last change:                          1






Tcl Built-In Commands                                 lappend(1T)



     
       ATRIBUTE TYPE     ATRIBUTE VALUE
    
     Availability         SUNWTcl        
    
     Interface Stability  Uncommitted    
    

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













































Tcl                       Last change:                          2