|MBSTOWCS(3)||Library Functions Manual||MBSTOWCS(3)|
converts a multibyte character string to a wide-character
* restrict pwcs, const
char * restrict s, size_t
mbstowcs() converts a null-terminated
multibyte character string pointed to by s to the
corresponding wide-character string and stores up to n
wide characters in the array pointed to by pwcs. Each
character will be converted as if
mbtowc(3) is continuously called, except
the internal state of mbtowc(3) will not
For state-dependent encoding,
implies the multibyte character string pointed to by s
always begin with an initial state.
These are the special cases:
mbstowcs() returns the number of elements to store the whole wide-character string corresponding to the multibyte character string pointed to by s. In this case, n is ignored.
mbstowcs() sets errno to indicate the error.
mbstowcs() may cause an error in the
mbstowcs() function conforms to
ANSI X3.159-1989 (“ANSI C89”).
The restrict qualifier is added at ISO/IEC 9899/199 (“ISO
|October 24, 2015||OpenBSD-current|