tcl/doc/lappend.n

   1 '\"
   2 '\" Copyright (c) 1993 The Regents of the University of California.
   3 '\" Copyright (c) 1994-1996 Sun Microsystems, Inc.
   4 '\"
   5 '\" See the file "license.terms" for information on usage and redistribution
   6 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
   7 '\"
   8 '\" RCS: @(#) $Id$
   9 '\"
  10 .so man.macros
  11 .TH lappend n "" Tcl "Tcl Built-In Commands"
  12 .BS
  13 '\" Note:  do not modify the .SH NAME line immediately below!
  14 .SH NAME
  15 lappend \- Append list elements onto a variable
  16 .SH SYNOPSIS
  17 \fBlappend \fIvarName \fR?\fIvalue value value ...\fR?
  18 .BE
  19
  20 .SH DESCRIPTION
  21 .PP
  22 This command treats the variable given by \fIvarName\fR as a list
  23 and appends each of the \fIvalue\fR arguments to that list as a separate
  24 element, with spaces between elements.
  25 If \fIvarName\fR doesn't exist, it is created as a list with elements
  26 given by the \fIvalue\fR arguments.
  27 \fBLappend\fR is similar to \fBappend\fR except that the \fIvalue\fRs
  28 are appended as list elements rather than raw text.
  29 This command provides a relatively efficient way to build up
  30 large lists.  For example, ``\fBlappend a $b\fR'' is much
  31 more efficient than ``\fBset a [concat $a [list $b]]\fR'' when
  32 \fB$a\fR is long.
  33
  34 .SH KEYWORDS
  35 append, element, list, variable