diff options
| author | dgp <dgp@users.sourceforge.net> | 2007-10-26 20:11:50 (GMT) |
|---|---|---|
| committer | dgp <dgp@users.sourceforge.net> | 2007-10-26 20:11:50 (GMT) |
| commit | 6b9dd216db20bac6c76552a6193d67a01e1d34ee (patch) | |
| tree | b86166558de62f70eef1a7524fac75f7b47a4f44 /doc/split.n | |
| parent | 236c395276f8f1cf4d5b745ea490b4966e6eb148 (diff) | |
| download | tcl-6b9dd216db20bac6c76552a6193d67a01e1d34ee.zip tcl-6b9dd216db20bac6c76552a6193d67a01e1d34ee.tar.gz tcl-6b9dd216db20bac6c76552a6193d67a01e1d34ee.tar.bz2 | |
* changes: Updated for 8.5b2 release.core_8_5_b2
* doc/*.1: Revert doc changes that broke
* doc/*.3: `make html` so we can get the release
* doc/*.n: out the door.
Diffstat (limited to 'doc/split.n')
| -rw-r--r-- | doc/split.n | 17 |
1 files changed, 8 insertions, 9 deletions
diff --git a/doc/split.n b/doc/split.n index c41aada..48a83cf 100644 --- a/doc/split.n +++ b/doc/split.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: split.n,v 1.6 2007/10/25 09:25:27 dkf Exp $ +'\" RCS: @(#) $Id: split.n,v 1.7 2007/10/26 20:11:53 dgp Exp $ '\" .so man.macros .TH split n "" Tcl "Tcl Built-In Commands" @@ -16,6 +16,7 @@ split \- Split a string into a proper Tcl list .SH SYNOPSIS \fBsplit \fIstring \fR?\fIsplitChars\fR? .BE + .SH DESCRIPTION .PP Returns a list created by splitting \fIstring\fR at each character @@ -32,32 +33,28 @@ If \fIsplitChars\fR is an empty string then each character of .SH EXAMPLES Divide up a USENET group name into its hierarchical components: .CS -.ta 2i \fBsplit\fR "comp.lang.tcl.announce" . - \fB\(->\fI comp lang tcl announce\fR + \fI=> comp lang tcl announce\fR .CE .PP See how the \fBsplit\fR command splits on \fIevery\fR character in \fIsplitChars\fR, which can result in information loss if you are not careful: .CS -.ta 2i \fBsplit\fR "alpha beta gamma" "temp" - \fB\(->\fI al {ha b} {} {a ga} {} a\fR + \fI=> al {ha b} {} {a ga} {} a\fR .CE .PP Extract the list words from a string that is not a well-formed list: .CS -.ta 2i \fBsplit\fR "Example with {unbalanced brace character" - \fB\(->\fI Example with \\{unbalanced brace character\fR + \fI=> Example with \\{unbalanced brace character\fR .CE .PP Split a string into its constituent characters .CS -.ta 2i \fBsplit\fR "Hello world" {} - \fB\(->\fI H e l l o { } w o r l d\fR + \fI=> H e l l o { } w o r l d\fR .CE .SS "PARSING RECORD-ORIENTED FILES" Parse a Unix /etc/passwd file, which consists of one entry per line, @@ -83,7 +80,9 @@ foreach rec $records { puts "$longName uses [file tail $shell] for a login shell" } .CE + .SH "SEE ALSO" join(n), list(n), string(n) + .SH KEYWORDS list, split, string |