C in a Nutshell

Name

wcstok

Synopsis

Divides a wide string into tokens

#include <wchar.h>
wchar_t *wcstok( wchar_t * restrict s1, const wchar_t * restrict s2,
                 wchar_t ** restrict ptr );

The wcstok() function isolates tokens in the wide string addressed by s1 that are delimited by any of the wide characters contained in the string addressed by s2. The tokens are identified one at a time by successive calls to wcstok(). On calls after the first, the s1 argument is a null pointer. The third argument is a pointer to a wchar_t pointer; wcstok() stores caller-specific information at the location addressed by this pointer for use on successive calls in the same sequence.

On the first call, wcstok() searches in s1 for the first character that does not match any character in s2, similarly to the wcsspn() function. The first such wide character found is considered to be the beginning of a token. Then wcstok() searches further for the first wide character that does match any of the wide characters in s2—or the null wide character that terminates the string, whichever comes first—similarly to the wcscspn() function. The first such wide character found is considered to be the delimiter that ends the token. wcstok() then replaces this ending delimiter with L'\0', and returns a pointer to the beginning of the token (or a null pointer if no token was found), after storing a value in the location addressed by the ptr argument for use in subsequent wcstok() calls.

On each subsequent call with a null pointer as the s1 ...