diff options
| author | dkf <donal.k.fellows@manchester.ac.uk> | 2004-05-11 21:31:43 (GMT) |
|---|---|---|
| committer | dkf <donal.k.fellows@manchester.ac.uk> | 2004-05-11 21:31:43 (GMT) |
| commit | 0d8310f9be1577fb211b01fbbe020ea6621fc1e5 (patch) | |
| tree | d38fb71406c5f145444e5305ee7e3791553a4fb2 /doc/join.n | |
| parent | 1b15374de9cd59a90154ade5bea0d5c07ed20133 (diff) | |
| download | tcl-0d8310f9be1577fb211b01fbbe020ea6621fc1e5.zip tcl-0d8310f9be1577fb211b01fbbe020ea6621fc1e5.tar.gz tcl-0d8310f9be1577fb211b01fbbe020ea6621fc1e5.tar.bz2 | |
Added examples
Diffstat (limited to 'doc/join.n')
| -rw-r--r-- | doc/join.n | 18 |
1 files changed, 16 insertions, 2 deletions
@@ -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: join.n,v 1.3 2000/09/07 14:27:48 poenitz Exp $ +'\" RCS: @(#) $Id: join.n,v 1.4 2004/05/11 21:31:43 dkf Exp $ '\" .so man.macros .TH join n "" Tcl "Tcl Built-In Commands" @@ -24,9 +24,23 @@ This command returns the string formed by joining all of the elements of \fIlist\fR together with \fIjoinString\fR separating each adjacent pair of elements. The \fIjoinString\fR argument defaults to a space character. +.SH EXAMPLES +Making a comma-separated list: +.CS +set data {1 2 3 4 5} +join $data ", " + \fB=> 1, 2, 3, 4, 5\fR +.CE + +Using \fBjoin\fR to flatten a list by a single level: +.CS +set data {1 {2 3} 4 {5 {6 7} 8}} +join $data + \fB=> 1 2 3 4 5 {6 7} 8\fR +.CE .SH "SEE ALSO" -list(n), lappend(n) +list(n), lappend(n), split(n) .SH KEYWORDS element, join, list, separator |