mbtowc
- convert a character to a wide-character code
LIBRARY
Lb libc
SYNOPSIS
#include <stdlib.h> int
Fo mbtowc
Fa wchar_t * restrict wcharp const char * restrict mbchar
Fa size_t nbytes
Fc
DESCRIPTION
The
mbtowc ();
function converts a multibyte character
Fa mbchar
into a wide character according to the current conversion state,
and stores the result
in the object pointed to by
Fa wcharp .
Up to
Fa nbytes
bytes are examined.
A call with a null
Fa mbchar
pointer returns nonzero if the current encoding 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
mbtowc ();
function returns nonzero if shift states are supported,
zero otherwise.
Otherwise, if
Fa mbchar
is not a null pointer,
mbtowc ();
either returns 0 if
Fa mbchar
represents the null wide character, or returns
the number of bytes processed in
Fa mbchar ,
or returns -1 if no multibyte character
could be recognized or converted.
In this case,
mbtowc (Ns 's);
internal conversion state is undefined.
