wcstombs(3int) [ultrix man page]

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)

mbtowc(3int)															      mbtowc(3int)

Name
       mbtowc - converts a single multibyte character into a character of type wchar_t

Syntax
       #include <stdlib.h>

       int mbtowc (pwc, s, n)
       wchar_t *pwc;
       const char *s;
       size_t n;

Arguments
       pwc     The pwc argument is a pointer to the resulting object of type wchar_t.

       s       The s argument is a pointer to a multibyte character.

       n       The n argument is the maximum number of bytes of object s that are examined.

Description
       If  s  is  not  a null pointer, the function determines the number of bytes that comprise the multibyte character pointed to by s.  It then
       determines the character code for the value (of type wchar_t) that corresponds to that multibyte character (the value of  the  code  corre-
       sponding to the null character is zero). If the multibyte character is valid and pwc is not a null pointer, the function stores the code in
       the object pointed to by pwc.  At most n bytes of the array pointed to by s are examined.  This function is affected by the LC_CTYPE  cate-
       gory of the current locale.

Return Values
       If s is a null pointer, the function returns a zero value.  If s is not a null pointer, the function returns:

	  o  0, if s points to the null character

	  o  The number of bytes that comprise the converted multibye character, if the next n or fewer bytes form a valid multibye character

	  o  - -1, if the next n or fewer bytes do not form a valid multibye character

       In no case is the value returned greater than n or the value of the MB_CUR_MAX macro.

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

																      mbtowc(3int)