append.n
上传用户:rrhhcc
上传日期:2015-12-11
资源大小:54129k
文件大小:1k
- '"
- '" 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: append.n,v 1.4.2.1 2004/10/27 09:35:38 dkf Exp $
- '"
- .so man.macros
- .TH append n "" Tcl "Tcl Built-In Commands"
- .BS
- '" Note: do not modify the .SH NAME line immediately below!
- .SH NAME
- append - Append to variable
- .SH SYNOPSIS
- fBappend fIvarName fR?fIvalue value value ...fR?
- .BE
- .SH DESCRIPTION
- .PP
- Append all of the fIvaluefR arguments to the current value
- of variable fIvarNamefR. If fIvarNamefR doesn't exist,
- it is given a value equal to the concatenation of all the
- fIvaluefR arguments.
- The result of this command is the new value stored in variable
- fIvarNamefR.
- This command provides an efficient way to build up long
- variables incrementally.
- For example, ``fBappend a $bfR'' is much more efficient than
- ``fBset a $a$bfR'' if fB$afR is long.
- .SH EXAMPLE
- Building a string of comma-separated numbers piecemeal using a loop.
- .CS
- set var 0
- for {set i 1} {$i<=10} {incr i} {
- fBappendfR var "," $i
- }
- puts $var
- # Prints 0,1,2,3,4,5,6,7,8,9,10
- .CE
- .SH "SEE ALSO"
- concat(n), lappend(n)
- .SH KEYWORDS
- append, variable