mbtowc() -- convert multibyte character to wide character

SYNOPSIS

#include <stdlib.h>

int mbtowc(wchar_t *pwc, const char *s, size_t n);

DESCRIPTION

The mbtowc() function converts the multibyte character addressed by s into the corresponding UNICODE character.

PARAMETERS

pwc: Is the address of a wide character, type wchar_t, to receive the UNICODE equivalent of s.
s: Points to the multibyte character to be converted to UNICODE.
n: Is the maximum width, in bytes, for which to scan s for a valid multibyte sequence. Regardless of the value of n, no more than MB_CUR_MAX bytes are examined.

If successful, mbtowc() returns the length, in bytes, of the multibyte character for which it found a UNICODE equivalent. If s is null or points to a null character, mbtowc() returns zero. If no valid multibyte sequence is found at s, mbtowc() returns -1.