The
wcrtomb ();
function stores a multibyte sequence representing the
wide character
Fa wc ,
including any necessary shift sequences, to the
character array
Fa s ,
storing a maximum of
MB_CUR_MAX
bytes.
If
Fa s
is
NULL
wcrtomb ();
behaves as if
Fa s
pointed to an internal buffer and
Fa wc
was a null wide character (L'\0').
The
mbstate_t
argument,
Fa ps ,
is used to keep track of the shift state.
If it is
NULL
wcrtomb ();
uses an internal, static
Vt mbstate_t
object, which is initialized to the initial conversion state
at program startup.
RETURN VALUES
The
wcrtomb ();
functions returns the length (in bytes) of the multibyte sequence
needed to represent
Fa wc ,
or
Po Vt size_t Pc Ns -1
if
Fa wc
is not a valid wide character code.
