libc.info: strtok

Go forward to strupr
Go backward to strstr
Go up to Strings
Go to the top op libc

`strtok',`strtok_r',`strsep'--get next token from a string

*Synopsis*
     #include <string.h>
     char *strtok(char *SOURCE, const char *DELIMITERS)
     char *strtok_r(char *SOURCE, const char *DELIMITERS,
         char **LASTS)
     char *strsep(char **SOURCE_PTR, const char *DELIMITERS)
   *Description*
The `strtok' function is used to isolate sequential tokens in a
null-terminated string, `*SOURCE'. These tokens are delimited in the
string by at least one of the characters in `*DELIMITERS'.  The first
time that `strtok' is called, `*SOURCE' should be specified; subsequent
calls, wishing to obtain further tokens from the same string, should
pass a null pointer instead.  The separator string, `*DELIMITERS', must
be supplied each time, and may change between calls.
   The `strtok' function returns a pointer to the beginning of each
subsequent token in the string, after replacing the separator character
itself with a NUL character.  When no more tokens remain, a null
pointer is returned.
   The `strtok_r' function has the same behavior as `strtok', except a
pointer to placeholder `*[lasts'> must be supplied by the caller.
   The `strsep' function is similar in behavior to `strtok', except a
pointer to the string pointer must be supplied `[source_ptr'> and the
function does not skip leading delimeters.  When the string starts with
a delimeter, the delimeter is changed to the NUL character and the
empty string is returned.  Like `strtok_r' and `strtok', the
`*[source_ptr'> is updated to the next character following the last
delimeter found or NULL if the end of string is reached with no more
delimeters.
*Returns*
`strtok', `strtok_r', and `strsep' all return a pointer to the next
token, or `NULL' if no more tokens can be found.  For `strsep', a token
may be the empty string.
*Portability*
`strtok' is ANSI C.  `strtok_r' is POSIX.  `strsep' is a BSD-extension.
   `strtok', `strtok_r', and `strsep' require no supporting OS
subroutines.