wctomb(3int)wctomb(3int)Namewctomb - converts a character of type wchar_t to a multibyte character.
Syntax
#include <stdlib.h>
int wctomb (s, wchar)
char *s;
wchar_t wchar;
Arguments
s The s argument is a pointer to the resulting multibyte charac‐
ter object.
wchar The wchar argument is a value of type wchar_t.
Description
The function determines the number of bytes needed to represent the
multibyte character corresponding to the character code of type wchar_t
whose value is wchar. It stores the multibyte character representation
in the array object pointed to by s (if s is not a null pointer). At
most MB_CUR_MAX characters are stored. This function is affected by
the LC_CTYPE category of the current locale.
Return Value
If s is a null pointer, the function returns a zero value. If s is not
a null pointer, the function returns:
· - -1, if the value of wchar does not correspond to a valid multi‐
bye character
· The number of bytes that comprise the multibyte character corre‐
sponding to the value of wchar. In no case is the value returned
greater than the value of the MB_CUR_MAX macro.
See Alsomblen(3int), mbtowc(3int), mbstowcs(3int), setlocale(3int),
wcstombs(3int)wctomb(3int)