strsep

STRSEP(3)		  Linux Programmer’s Manual		    STRSEP(3)



NAME
       strsep - extract token from string

SYNOPSIS
       #include <string.h>

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

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.

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

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

CONFORMING TO
       BSD 4.4

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



GNU				  1993-04-12			    STRSEP(3)