wctomb
- convert a wide-character code to a character
LIBRARY
Lb libc
SYNOPSIS
#include <stdlib.h> int
wctomb (char *mbchar wchar_t wchar);
DESCRIPTION
The
wctomb ();
function converts a wide character
Fa wchar
into a multibyte character and stores
the result in
Fa mbchar .
The object pointed to by
Fa mbchar
must be large enough to accommodate the multibyte character, which
may be up to
MB_LEN_MAX
bytes.
A call with a null
Fa mbchar
pointer returns nonzero if the current locale requires shift states,
zero otherwise;
if shift states are required, the shift state is reset to the initial state.
RETURN VALUES
If
Fa mbchar
is
NULL
the
wctomb ();
function returns nonzero if shift states are supported,
zero otherwise.
If
Fa mbchar
is valid,
wctomb ();
returns
the number of bytes processed in
Fa mbchar ,
or -1 if no multibyte character
could be recognized or converted.
In this case,
wctomb (Ns 's);
internal conversion state is undefined.
