strsep (3) - Linux Manuals
strsep: extract token from string
NAME
strsep - extract token from string
SYNOPSIS
#include <string.h> char *strsep(char **stringp, const char *delim);
Feature Test Macro Requirements for glibc (see feature_test_macros(7)):
strsep():
DESCRIPTION
If
*stringp
is NULL, the
strsep()
function returns NULL
and does nothing else.
Otherwise, this function finds the first token
in the string
*stringp,
that is delimited by one of the bytes in the string
delim.
This token is terminated by overwriting the delimiter
with a null byte ('\0'),
and
*stringp
is updated to point past the token.
In case no delimiter was found, the token is taken to be
the entire string
*stringp,
and
*stringp
is made NULL.
RETURN VALUE
The
strsep()
function returns a pointer to the token,
that is, it returns the original value of
*stringp.
ATTRIBUTES
For an explanation of the terms used in this section, see
attributes(7).
Interface Attribute Value
strsep()
Thread safety MT-Safe CONFORMING TO
4.4BSD.
NOTES
The
strsep()
function was introduced as a replacement for
strtok(3),
since the latter cannot handle empty fields.
However,
strtok(3)
conforms to C89/C99 and hence is more portable.
BUGS
Be cautious when using this function.
If you do use it, note that:
COLOPHON
This page is part of release 5.10 of the Linux
man-pages
project.
A description of the project,
information about reporting bugs,
and the latest version of this page,
can be found at
https://www.kernel.org/doc/man-pages/.
SEE ALSO
index(3),
memchr(3),
rindex(3),
strchr(3),
string(3),
strpbrk(3),
strspn(3),
strstr(3),
strtok(3)