Libc-1081.1.3.tar.gz

[apple/libc.git] / string / FreeBSD / strsep.3

diff --git a/string/FreeBSD/strsep.3 b/string/FreeBSD/strsep.3
index 0218aea34b9c0bdb1b4fa38bf3f63fa7a04d890b..ae0259a65ca4296f418bac26fa26104556bd6ec3 100644 (file)
--- a/string/FreeBSD/strsep.3
+++ b/string/FreeBSD/strsep.3
@@ -12,10 +12,6 @@
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
-.\" 3. All advertising materials mentioning features or use of this software
-.\"    must display the following acknowledgement:
-.\"    This product includes software developed by the University of
-.\"    California, Berkeley and its contributors.
 .\" 4. Neither the name of the University nor the names of its contributors
 .\"    may be used to endorse or promote products derived from this software
 .\"    without specific prior written permission.
@@ -33,9 +29,9 @@
 .\" SUCH DAMAGE.
 .\"
 .\"    @(#)strsep.3    8.1 (Berkeley) 6/9/93
-.\" $FreeBSD: src/lib/libc/string/strsep.3,v 1.13 2002/11/29 15:57:49 ru Exp $
+.\" $FreeBSD: src/lib/libc/string/strsep.3,v 1.16 2008/12/05 15:50:59 pjd Exp $
 .\"
-.Dd June 9, 1993
+.Dd December 5, 2008
 .Dt STRSEP 3
 .Os
 .Sh NAME
@@ -85,6 +81,21 @@ returns
 .Sh EXAMPLES
 The following uses
 .Fn strsep
+to parse a string, and prints each token in separate line:
+.Bd -literal -offset indent
+char *token, *string, *tofree;
+
+tofree = string = strdup("abc,def,ghi");
+assert(string != NULL);
+
+while ((token = strsep(&string, ",")) != NULL)
+       printf("%s\en", token);
+
+free(tofree);
+.Ed
+.Pp
+The following uses
+.Fn strsep
 to parse a string, containing tokens delimited by white space, into an
 argument vector:
 .Bd -literal -offset indent
@@ -115,7 +126,7 @@ While the
 .Fn strtok
 function should be preferred for portability reasons (it conforms to
 .St -isoC )
-it is unable to handle empty fields, i.e. detect fields delimited by
+it is unable to handle empty fields, i.e., detect fields delimited by
 two adjacent delimiter characters, or to be used for more than a single
 string at a time.
 The