Convert a multibyte character array to a wchar_t array.

This function is compatible with the following targets:

ANSI

BeOS

EMB/RTOS

Mac OS

Palm OS

Win32

#include <stddlib.h>

size_t mbstowcs(wchar_t *pwcs, 

Parameters for this facility are:

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

The mbstowcs() function converts a character array containing multibyte characters to a wide character array containing wchar_t type characters. The wchar_t type is defined in stddef.h.

The Metrowerks C implementation of mbstowcs() performs no translation; it copies a maximum of n bytes from the array pointed to by s to the array pointed to by pwcs. The function terminates prematurely if a null character is reached.

mbstowcs() returns the number of bytes copied from s to pwcs.

"Locale specification"

"wcstombs"