NAME | SYNOPSIS | DESCRIPTION | NOTES | ATTRIBUTES | SEE ALSO | STANDARDS | RESTRICTIONS
#include <string.h>char *strtok(char *str, const char *sep);
The strtok function is used to isolate sequential tokens in a null-terminated string, str. These tokens are separated in the string by at least one of the characters in sep. The first time strtok is called, str should be specified; subsequent calls, wishing to obtain further tokens from the same string, should pass the NULL pointer instead. The separator string, sep, 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 token itself with a null-character. When no more tokens remain, the NULL pointer is returned.
The interface is inappropriate to a thread-safe implementation. Therefore this function is not reentrant. For a reentrant equivalent, use strtok_r (3STDC), which conforms to POSIX.1c.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Interface Stability | Evolving |
index(3STDC), memchr(3STDC), rindex(3STDC), string(3STDC), strcspn(3STDC), strsep(3STDC), strtok_r(3STDC)
The strtok function conforms to ANSI-C.
It is not possible to get tokens from multiple strings simultaneously.
The System V strtok, if handed a string containing only delimiter characters, will not alter the next starting point, so that a call to strtok with a different (or empty) delimiter string may return a non- NULL value. As this implementation always alters the next starting point, this sequence of calls will always return NULL.
NAME | SYNOPSIS | DESCRIPTION | NOTES | ATTRIBUTES | SEE ALSO | STANDARDS | RESTRICTIONS