Translate a multibyte character to a wchar_t type.

This function is compatible with the following targets:

ANSI

BeOS

EMB/RTOS

Mac OS

Palm OS

Win32

#include <stdlib.h>

int mbtowc(wchar_t *pwc,

Parameters for this facility are:

pwc	wchar_t *	The wide character destination
s	const char *s	The string to convert
n	size_t	The maximum wide characters to convert

The mbtowc() function converts a multibyte character, pointed to by s, to a character of type wchar_t, pointed to by pwc. The function converts a maximum of n bytes.

The Metrowerks C implementation performs no translation; it copies the first character at s to the first character at pwc.

mbtowc() returns -1 if n is zero and s is not a null pointer.

mbtowc() returns 0 if s is a null pointer or s points to a null character ('\0').

mbtowc() returns 1 if s is not a null pointer and it does not point to a null character ('\0').

"Locale specification"

"mblen"

"wctomb"