Subversion Repositories or1k_old

'\"

'\" Copyright (c) 1993 The Regents of the University of California.

'\" Copyright (c) 1994-1996 Sun Microsystems, Inc.

'\"

'\" See the file "license.terms" for information on usage and redistribution

'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.

'\"

'\" RCS: @(#) $Id: lappend.n,v 1.1.1.1 2002-01-16 10:25:24 markom Exp $

'\"

.so man.macros

.TH lappend n "" Tcl "Tcl Built-In Commands"

.BS

'\" Note:  do not modify the .SH NAME line immediately below!

.SH NAME

lappend \- Append list elements onto a variable

.SH SYNOPSIS

\fBlappend \fIvarName \fR?\fIvalue value value ...\fR?

.BE

.SH DESCRIPTION

.PP

This command treats the variable given by \fIvarName\fR as a list

and appends each of the \fIvalue\fR arguments to that list as a separate

element, with spaces between elements.

If \fIvarName\fR doesn't exist, it is created as a list with elements

given by the \fIvalue\fR arguments.

\fBLappend\fR is similar to \fBappend\fR except that the \fIvalue\fRs

are appended as list elements rather than raw text.

This command provides a relatively efficient way to build up

large lists.  For example, ``\fBlappend a $b\fR'' is much

more efficient than ``\fBset a [concat $a [list $b]]\fR'' when

\fB$a\fR is long.

.SH KEYWORDS

append, element, list, variable