STRSEP(P)           Linux Programmer's Manual           STRSEP(P)



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 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
       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() conforms to ANSI-C  and  hence  is  more
       portable.

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

CONFORMING TO
       BSD 4.4

SEE ALSO
       index(x),  memchr(r),  rindex(x),  strchr(r),  strpbrk(k),
       strspn(n), strstr(r), strtok(k)



GNU                         1993-04-12                  STRSEP(P)