.Sh SYNOPSIS
.In wchar.h
.Ft wchar_t *
-.Fn wcstok "wchar_t * restrict str" "const wchar_t * restrict sep" "wchar_t ** restrict last"
+.Fo wcstok
+.Fa "wchar_t *restrict ws1"
+.Fa "const wchar_t *restrict ws2"
+.Fa "wchar_t **restrict ptr"
+.Fc
.Sh DESCRIPTION
The
.Fn wcstok
function
is used to isolate sequential tokens in a null-terminated wide character
string,
-.Fa str .
+.Fa ws1 .
These tokens are separated in the string by at least one of the
characters in
-.Fa sep .
+.Fa ws2 .
The first time that
.Fn wcstok
is called,
-.Fa str
+.Fa ws1
should be specified; subsequent calls, wishing to obtain further tokens
from the same string, should pass a null pointer instead.
The separator string,
-.Fa sep ,
+.Fa ws2 ,
must be supplied each time, and may change between calls.
-The context pointer
-.Fa last
+The context pointer,
+.Fa ptr ,
must be provided on each call.
.Pp
The
.Sh EXAMPLES
The following code fragment splits a wide character string on
.Tn ASCII
-space, tab and newline characters and writes the tokens to
-standard output:
+space, tab, and newline characters,
+writing the resulting tokens to standard output:
.Bd -literal -offset indent
const wchar_t *seps = L" \et\en";
wchar_t *last, *tok, text[] = L" \enone\ettwo\et\etthree \en";
.Fn wcstok
omit the
context pointer argument,
-.Fa last ,
+.Fa ptr ,
and maintain state across calls in a static variable like
.Fn strtok
does.