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
() may store at most
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
. 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
the internal state of
(), 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
() 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 character.
is equal to
- The current encoding is state-independent.
- The current encoding is state-dependent.
No errors are defined.
() function conforms to