Divides a specified string into some tokens.

[Format]

#include <wchar.h>

wchar_t* wcstok(wchar_t * restrict s1, const wchar_t * restrict s2, wchar_t ** restrict ptr);

[Parameters]

s1 Pointer to the string to be divided into some tokens

s2 Pointer to the string representing string-dividing characters

ptr Pointer to the string where search is to be started at the next function call

[Return values]

If division into tokens is successful: Pointer to the first token divided

If division into tokens is unsuccessful: NULL

[Remarks]

The wcstok function is the wide-character version of the strtok function.

To search the same string for the second or later time, set s1 to NULL and ptr to the value returned by the previous function call to the same string.