wcstombs(3int) wcstombs(3int)
Name
wcstombs - converts a string of type wchar_t into a multibyte character string
Syntax
#include <stdlib.h>
int wcstombs (s, pwcs, n)
char *s;
const wchar_t *pwcs;
size_t n;
Arguments
s The s argument is a pointer to the resulting multibyte character string.
pwcs The pwcs argument is a pointer to the source array of wide characters.
n The n argument is the maximum number of resulting bytes in the array pointed to by s.
Description
The function converts a sequence of character codes of type from the array pointed to by pwcs into a sequence of multibyte characters. The
function stores the multibyte characters in the array pointed to by s, stopping if a multibyte character would exceed the limit of n total
bytes or if a null character is stored. Each character is converted as if by a call to the function. No more than n bytes are modified in
the array pointed to by s. This function is affected by the LC_CTYPE category of the current locale.
Return Values
If a character is encountered that does not correspond to a valid multi-byte character, the function returns Otherwise, the function
returns the number of bytes modified, not including a terminating null character, if any. The array will not be null-terminated if the
value returned is n.
See Also
mblen(3int), mbtowc(3int), mbstowcs(3int), setlocale(3int), wctomb(3int)
wcstombs(3int)
