ultrix man page for wctomb

wctomb(3int)															      wctomb(3int)

Name
       wctomb - 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 character 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:

	  o  - -1, if the value of wchar does not correspond to a valid multibye character

	  o  The  number  of  bytes  that  comprise the multibyte character corresponding to the value of wchar.  In no case is the value returned
	     greater than the value of the MB_CUR_MAX macro.

See Also
       mblen(3int), mbtowc(3int), mbstowcs(3int), setlocale(3int), wcstombs(3int)

																      wctomb(3int)