|WCTOMB(3)||Library Functions Manual||WCTOMB(3)|
wctomb — converts
a wide character to a multibyte character
* s, wchar_t
function converts the wide character wchar to the
corresponding multibyte character, and stores it in the array pointed to by
wctomb() may store at most
MB_CUR_MAX bytes in the array.
In state-dependent encoding,
may 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 state.
Calling any other functions in
libc never change
the internal state of
except for calling setlocale(3) with
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
is affected by
LC_CTYPE category of the current
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
|March 29, 2022||OpenBSD-current|