lappend.n
上传用户:rrhhcc
上传日期:2015-12-11
资源大小:54129k
文件大小:2k
- '"
- '" Copyright (c) 1993 The Regents of the University of California.
- '" Copyright (c) 1994-1996 Sun Microsystems, Inc.
- '" Copyright (c) 2001 Kevin B. Kenny. All rights reserved.
- '"
- '" 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.6.4.1 2004/10/27 12:52:40 dkf 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 fIvarNamefR as a list
- and appends each of the fIvaluefR arguments to that list as a separate
- element, with spaces between elements.
- If fIvarNamefR doesn't exist, it is created as a list with elements
- given by the fIvaluefR arguments.
- fBLappendfR is similar to fBappendfR except that the fIvaluefRs
- 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 $bfR'' is much
- more efficient than ``fBset a [concat $a [list $b]]fR'' when
- fB$afR is long.
- .SH EXAMPLE
- Using fBlappendfR to build up a list of numbers.
- .CS
- % set var 1
- 1
- % fBlappendfR var 2
- 1 2
- % fBlappendfR var 3 4 5
- 1 2 3 4 5
- .CE
- .SH "SEE ALSO"
- list(n), lindex(n), linsert(n), llength(n),
- .VS 8.4
- lset(n)
- .VE
- lsort(n), lrange(n)
- .SH KEYWORDS
- append, element, list, variable