lappend varName ?value value ...?
----
http://www.purl.org/tcl/home/man/tcl8.4/TclCmd/lappend.htm
----

Appends each ''value'' as a list [element] onto the end of the list stored in ''varName''. 

''lappend'' is the only list-command which requires the '''name''' of the list rather than the list itself.

 lappend listName
rather than
 lappend $listName

This command differs from [append] in that values are appended as list elements rather than raw text.

lappend will not ''make'' varName a list ; if it is one before the command, it will continue to be one.

You do not need to assign the results of lappend to varName; lappend
modifies varName directly.
----

See also [list], [lindex], [linsert], [llength], [lrange], [lreplace], [lsearch], [lsort] .

----

[Tcl syntax help] - [Arts and crafts of Tcl-tk programming]
- [Category Command]