| WCSTOK(3) | Library Functions Manual | WCSTOK(3) | 
wcstok —
#include <wchar.h>
wchar_t *
  
  wcstok(wchar_t
    * restrict str, const
    wchar_t * restrict sep,
    wchar_t ** restrict
    last);
wcstok() function is used to isolate sequential
  tokens in a nul-terminated wide-character string, str.
  These tokens are separated in the string by at least one of the characters in
  sep. The first time that
  wcstok() is called, str should
  be specified; subsequent calls, wishing to obtain further tokens from the same
  string, should pass a null pointer instead. The separator string,
  sep, must be supplied each time, and may change between
  calls. The context pointer last must be provided on each
  call.
The wcstok() function is the
    wide-character counterpart of the strtok_r()
    function.
wcstok() function returns a pointer to the beginning
  of each subsequent token in the string, after replacing the token itself with
  a nul wide character (L'\0'). When no more tokens remain, a null pointer is
  returned.
const wchar_t *seps = L" \t\n";
wchar_t *last, *tok, text[] = L" \none\ttwo\t\tthree  \n";
for (tok = wcstok(text, seps, &last); tok != NULL;
    tok = wcstok(NULL, seps, &last))
	wprintf(L"%ls\n", tok);
wcstok() function conforms to
  ISO/IEC 9899:1999 (“ISO C99”).
Some early implementations of wcstok()
    omit the context pointer argument, last, and maintain
    state across calls in a static variable like
    strtok(3) does.
| October 3, 2002 | NetBSD 9.4 |