summaryrefslogtreecommitdiffstats
path: root/doc/append.n
diff options
context:
space:
mode:
authordkf <donal.k.fellows@manchester.ac.uk>2004-05-18 21:13:40 (GMT)
committerdkf <donal.k.fellows@manchester.ac.uk>2004-05-18 21:13:40 (GMT)
commit8f44551e03712b6046cecdfc9e8ce0ba1b4a5225 (patch)
treeab8e837c611fca31f791d3d2654766dd17df4573 /doc/append.n
parentef2d20c14f37350d6124e97746465aba1ad7dd3d (diff)
downloadtcl-8f44551e03712b6046cecdfc9e8ce0ba1b4a5225.zip
tcl-8f44551e03712b6046cecdfc9e8ce0ba1b4a5225.tar.gz
tcl-8f44551e03712b6046cecdfc9e8ce0ba1b4a5225.tar.bz2
Added example
Diffstat (limited to 'doc/append.n')
-rw-r--r--doc/append.n12
1 files changed, 11 insertions, 1 deletions
diff --git a/doc/append.n b/doc/append.n
index 5f1a3c7..d829c71 100644
--- a/doc/append.n
+++ b/doc/append.n
@@ -5,7 +5,7 @@
'\" 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 2003/02/10 13:32:22 dkf Exp $
+'\" RCS: @(#) $Id: append.n,v 1.5 2004/05/18 21:13:40 dkf Exp $
'\"
.so man.macros
.TH append n "" Tcl "Tcl Built-In Commands"
@@ -29,6 +29,16 @@ This command provides an efficient way to build up long
variables incrementally.
For example, ``\fBappend a $b\fR'' is much more efficient than
``\fBset a $a$b\fR'' if \fB$a\fR 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} {
+ append var "," $i
+}
+puts $var
+# Prints 0,1,2,3,4,5,6,7,8,9,10
+.CE
.SH "SEE ALSO"
concat(n), lappend(n)