diff options
Diffstat (limited to 'man3/strsep.3')
-rw-r--r-- | man3/strsep.3 | 70 |
1 files changed, 70 insertions, 0 deletions
diff --git a/man3/strsep.3 b/man3/strsep.3 new file mode 100644 index 000000000..0bb001bfb --- /dev/null +++ b/man3/strsep.3 @@ -0,0 +1,70 @@ +.\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk) +.\" +.\" Permission is granted to make and distribute verbatim copies of this +.\" manual provided the copyright notice and this permission notice are +.\" preserved on all copies. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" +.\" References consulted: +.\" Linux libc source code +.\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) +.\" 386BSD man pages +.\" Modified Sat Jul 24 18:00:10 1993 by Rik Faith (faith@cs.unc.edu) +.\" Modified Mon Jan 20 12:04:18 1997 by Andries Brouwer (aeb@cwi.nl) +.\" Modified Tue Jan 23 20:23:07 2001 by Andries Brouwer (aeb@cwi.nl) +.\" +.TH STRSEP 3 1993-04-12 "GNU" "Linux Programmer's Manual" +.SH NAME +strsep \- extract token from string +.SH SYNOPSIS +.nf +.B #include <string.h> +.sp +.BI "char *strsep(char **" stringp ", const char *" delim ); +.fi +.SH DESCRIPTION +If *\fIstringp\fP is NULL, the \fBstrsep()\fP function returns NULL +and does nothing else. Otherwise, this function finds the first token +in the string *\fIstringp\fP, where tokens +are delimited by symbols in the string \fIdelim\fP. +This token is terminated with a `\\0' character +(by overwriting the delimiter) +and *\fIstringp\fP is updated to point past the token. +In case no delimiter was found, the token is taken to be +the entire string *\fIstringp\fP, and *\fIstringp\fP is made NULL. +.SH "RETURN VALUE" +The \fBstrsep()\fP function returns a pointer to the token, +that is, it returns the original value of *\fIstringp\fP. +.SH NOTES +The \fBstrsep()\fP function was introduced as a replacement for +\fBstrtok()\fP, since the latter cannot handle empty fields. +However, \fBstrtok()\fP conforms to ANSI-C and hence is more portable. +.SH BUGS +This function suffers from the same problems as \fBstrtok()\fP. +In particular, it modifies the original string. Avoid it. +.SH "CONFORMING TO" +BSD 4.4 +.SH "SEE ALSO" +.BR index (3), +.BR memchr (3), +.BR rindex (3), +.BR strchr (3), +.BR strpbrk (3), +.BR strspn (3), +.BR strstr (3), +.BR strtok (3) |