Translate a wchar_t type character array to a multibyte character array.

This function is compatible with the following targets:

ANSI

BeOS

EMB/RTOS

Mac OS

Palm OS

Win32

#include <stdlib.h>

size_t wcstombs(char *s, const 

Parameters for this facility are:

s	char *	A multibyte string buffer
pwcs	const wchar_t *	A pointer to a wide character string to be converted
n	size_t	The maximum length to convert

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

The Metrowerks C implementation of wcstombs() performs no translation; it copies the lower eight bits from each of a maximum of n wide characters from the array pointed to by pwcs to the array pointed to by s. The function terminates prematurely if a null character is reached.

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

"Locale specification," "mbstowcs"