STRSEP(3)		   Linux Programmers Manual		    STRSEP(3)



NAME
       strsep - extract token from string

SYNOPSIS
       #include 

       char *strsep(char **stringp, const char *delim);

   Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

       strsep(): _BSD_SOURCE

DESCRIPTION
       If  *stringp is NULL, the strsep() function returns NULL and does noth
       ing else.  Otherwise, this function finds the first token in the string
       *stringp,  where  tokens  are delimited by symbols in the string delim.
       This token is terminated with a	'\0'  character  (by  overwriting  the
       delimiter) 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.

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) con
       forms to C89/C99 and hence is more portable.

BUGS
       This function suffers from the same problems as strtok(3).  In particu
       lar, it modifies the original string.  Avoid it.

SEE ALSO
       index(3),   memchr(3),  rindex(3),  strchr(3),  strpbrk(3),  strspn(3),
       strstr(3), strtok(3)

COLOPHON
       This page is part of release 3.05 of the Linux  man-pages  project.   A
       description  of	the project, and information about reporting bugs, can
       be found at http://www.kernel.org/doc/man-pages/.



GNU				  2007-07-26			     STRSEP(3)