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'' used to be the only list-command which requires the '''name of a variable containing a list''' rather than the list itself, but in Tcl 8.4 the [lset] command was introduced.

 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.
----
How would one append an item to the beginning of a list?
Since ''append'' means ''to the end of'', one wouldn't append to the beginning of a list.  Instead, for a way to perform the equivalent of ''prepend'', see [linsert] -- jfr

----

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

----

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