converts a wide character to a multibyte
() converts the wide character
to the corresponding multibyte
character, and stores it in the array pointed to by
store at most
bytes in the
In state-dependent encoding, wctomb
() may store the
special sequence to change the conversion state before an actual multibyte
character into the array pointed to by s
is a null wide character
(‘\0’), this function places its own internal state to an
initial conversion state.
Calling any other functions in libc
the internal state of wctomb
(), except for
category changed to that of the
current locale. Such
calls cause the
internal state of this function to be indeterminate.
The behaviour of wctomb
() is affected by
category of the current locale.
There is a special case:
- s == NULL
- 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.
- Number of bytes for the valid multibyte character pointed
to by s. There are no cases where the
value returned is greater than the value of the
- wchar is an invalid wide
is equal to
- The current encoding is state-independent.
- The current encoding is state-dependent.
No errors are defined.
() function conforms to