|WCSTOMBS(3)||Library Functions Manual||WCSTOMBS(3)|
converts a wide-character string to a multibyte character
* restrict s, const
wchar_t * restrict pwcs,
converts the null-terminated wide-character string pointed to by
pwcs to the corresponding multibyte character string,
and stores up to n bytes in the array pointed to by
s. Each character will be converted as if
wctomb(3) is continuously called, except
the internal state of wctomb(3) will not
For state-dependent encoding, the
implies the result multibyte character string pointed to by
s always to begin with an initial state.
The behaviour of the
is affected by the
LC_CTYPE category of the current
There are special cases:
wcstombs() returns the number of bytes to store the whole multibyte character string corresponding to the wide-character string pointed to by pwcs. In this case, n is ignored.
wcstombs() also sets errno to indicate the error.
wcstombs() may cause an error in the
wcstombs() function conforms to
ANSI X3.159-1989 (“ANSI C89”).
The restrict qualifier is added at ISO/IEC 9899/1999 (“ISO
|March 22, 2015||OpenBSD-current|