STRTOK(3) NEWLIB 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 subrou‐
tines.
SEE ALSOstrtok is part of the library. The full documentation for is main‐
tained as a Texinfo manual. If info and are properly installed at your
site, the command
info
will give you access to the complete manual.
NEWLIB April 2010 STRTOK(3)