|WCTOMB(3)||Library Functions Manual||WCTOMB(3)|
wctomb — converts
a wide character to a multibyte character
* s, wchar_t
wctomb() converts the wide character
wchar to the corresponding multibyte character, and
stores it in the array pointed to by s.
wctomb() may store at most
MB_CUR_MAX bytes in the array.
In state-dependent encoding,
store the special sequence to change the conversion state before an actual
multibyte character into the array pointed to by s. If
wchar is a null wide character (‘\0’),
this function places its own internal state to an initial conversion
Calling any other functions in libc never change
the internal state of
wctomb(), except for calling
setlocale(3) with the
LC_CTYPE category changed to that of the current
locale. Such setlocale(3) calls cause
the internal state of this function to be indeterminate.
The behaviour of
wctomb() is affected by
LC_CTYPE category of the current locale.
There is a special case:
wctomb() initializes its own internal state to an initial state, and determines whether the current encoding is state-dependent. This function returns 0 if the encoding is state-independent, otherwise non-zero. In this case, wchar is completely ignored.
If s is equal to
No errors are defined.
wctomb() function conforms to
|June 28, 2016||OpenBSD-current|