Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

lappend (1t)

Name

lappend - Append list elements onto a variable

Synopsis

lappend varName ?value value value ...?

Description

lappend(1t)                  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 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


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | runtime/tcl-8    |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+
SEE ALSO
       list(n),  lindex(n),   linsert(n),   llength(n),   lset(n),   lsort(n),
       lrange(n)

KEYWORDS
       append, element, list, variable



NOTES
       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source was downloaded from  http://prdownloads.sourceforge.net/tcl/tcl-
       core8.6.7-src.tar.gz

       Further information about this software can be found on the open source
       community website at https://www.tcl.tk/.



Tcl                                                                lappend(1t)