STRTOK(3)

NAME
6.37 `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 null 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 delimiters. When the string starts with a delimiter, the delimiter is changed to the null character and the empty string is returned. Like `strtok_r' and `strtok', the `*SOURCE_PTR' is updated to the next character following the last delimiter found or NULL if the end of string is reached with no more delimiters.

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.

SEE ALSO
strtok is part of the library. The full documentation for is maintained as a Texinfo manual. If info and are properly installed at your site, the command

    info

will give you access to the complete manual.