NAME    [Toc]    [Back]

       strsep - extract token from string

SYNOPSIS    [Toc]    [Back]

       #include <string.h>

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

DESCRIPTION    [Toc]    [Back]

       If  *stringp is NULL, the strsep() function returns NULL and does nothing
 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    [Toc]    [Back]

       The  strsep()  function	returns  a  pointer  to the token, that is, it
       returns the original value of *stringp.

NOTES    [Toc]    [Back]

       The strsep() function was introduced as	a  replacement	for  strtok(),
       since  the  latter  cannot handle empty fields.	However, strtok() conforms
 to ANSI-C and hence is more portable.

BUGS    [Toc]    [Back]

       This function suffers from the same problems as strtok().  In  particular,
 it modifies the original string. Avoid it.

CONFORMING TO    [Toc]    [Back]

       BSD 4.4

SEE ALSO    [Toc]    [Back]

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



GNU				  1993-04-12			     STRSEP(3)