wstring(3W)wstring(3W)NAME
wstring: wssize, wstok, strtows - wchar_t string operations and type
transformation
SYNOPSIS
#include <widec.h>
int wssize(wchar_t *s);
wchar_t *wstok(wchar_t *s1, wchar_t *s2);
wchar_t *strtows(wchar_t *s1, char *s2);
DESCRIPTION (International Functions)
The arguments s1, s2, and s point to wchar_t strings (that is, arrays of
wchar_t characters terminated by a wchar_t null character).
wssize returns the number of wchar_t characters in s, not including the
terminating wchar_t null character.
wstok treats the wchar_t string s1 as a sequence of zero or more text
tokens, separated by spans of one or more wchar_t characters from the
separator wchar_t string s2. The first call (with the pointer s1
specified) returns a pointer to the first wchar_t character of the first
token, and writes a wchar_t null character into s1 immediately following
the returned token. The function keeps track of its position in the
wchar_t string between separate calls, so that subsequent calls (which
must be made with the first argument a null pointer) will progress
through the wchar_t string s1 immediately following that token.
Similarly, subsequent calls will progress through the wchar_t string s1
until no tokens remain. The wchar_t separator string s2 may be different
from call to call. A null pointer is returned when no token remains in
s1.
strtows transforms EUC in character string s2 into wchar_t characters,
and transfers those to wchar_t string s1, stopping after the null
character has been processed.
SEE ALSOmalloc(3C), widec(3S), wcstring(3S), malloc(3X).
DIAGNOSTICS
On success, strtows returns s1. If an illegal byte sequence is detected,
a null pointer is returned and errno is set to EILSEQ.
Page 1
