lappend(3tcl) [debian man page]

lappend(3tcl)						       Tcl Built-In Commands						     lappend(3tcl)

__________________________________________________________________________________________________________________________________________________

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 does not 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(3tcl), lindex(3tcl), linsert(3tcl), llength(3tcl), lset(3tcl), lsort(3tcl), lrange(3tcl)

KEYWORDS

       append, element, list, variable

Tcl																     lappend(3tcl)

list(3tcl)						       Tcl Built-In Commands							list(3tcl)

__________________________________________________________________________________________________________________________________________________

NAME

       list - Create a list

SYNOPSIS

       list ?arg arg ...?
_________________________________________________________________

DESCRIPTION

       This  command  returns  a list comprised of all the args, or an empty string if no args are specified.  Braces and backslashes get added as
       necessary, so that the lindex command may be used on the result to re-extract the original arguments, and also so that eval may be used	to
       execute	the  resulting	list, with arg1 comprising the command's name and the other args comprising its arguments.  List produces slightly
       different results than concat:  concat removes one level of grouping before forming the list, while list works directly from  the  original
       arguments.

EXAMPLE

       The command
	      list a b "c d e  " "  f {g h}"
       will return
	      a b {c d e  } {  f {g h}}
       while concat with the same arguments will return
	      a b c d e f {g h}

SEE ALSO

       lappend(3tcl),	lindex(3tcl),  linsert(3tcl),  llength(3tcl),  lrange(3tcl),  lrepeat(3tcl),  lreplace(3tcl),  lsearch(3tcl),  lset(3tcl), |
       lsort(3tcl)

KEYWORDS

       element, list

Tcl																	list(3tcl)