Converts a multibyte character to a corresponding wide character.

#include stdlib.h>

int mbtowc (wchar_t *wchar, const char *mbchar, size_t count);

Parameters

wchar

A pointer to the wide character produced.

mbchar

A pointer to a sequence of bytes (a multibyte character).

count

The number of bytes to check.

Remarks

mbtowc will not examine more than MB_CUR_MAX bytes.

Return Values

The length in bytes of the multibyte character.

Success.

• (zero) if mbchar is a null pointer or the object that it points to is a wide-character null.
• -1 if the object that mbchar points to does not form a valid multibyte character within the first count characters.

Failure.

Requirements

See Also

mblen, mbstowcs, wcstombs, wctomb