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)