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.2 |