mbstring(3C)                                         mbstring(3C)



NAME
     mbstring: mbstowcs, wcstombs - multibyte string functions

SYNOPSIS
     #include <stdlib.h>

     size_t mbstowcs (pwcs, s, n);
     wchar_t *pwcs;
     char *s;
     size_t n;

     size_t wcstombs (s, pwcs, n);
     char *s;
     wchar_t *pwcs;
     size_t n;

DESCRIPTION
     mbstowcs converts a sequence of multibyte characters from
     the array pointed to by s into a sequence of corresponding
     wide character codes and stores these codes into the array
     pointed to by pwcs, stopping after n codes are stored or a
     code with value zero (a converted null character) is stored.
     If an invalid multibyte character is encountered, mbstowcs
     returns (size_t)-1.  Otherwise, mbstowcs returns the number
     of array elements modified, not including the terminating
     zero code, if any.

     wcstombs converts a sequence of wide character codes from
     the array pointed to by pwcs into a sequence of multibyte
     characters and stores these multibyte characters into the
     array pointed to by s, stopping if a multibyte character
     would exceed the limit of n total bytes or if a null charac-
     ter is stored.  If a wide character code is encountered that
     does not correspond to a valid multibyte character, wcstombs
     returns (size_t)-1.  Otherwise, wcstombs returns the number
     of bytes modified, not including a terminating null charac-
     ter, if any.

SEE ALSO
     mbchar(3C), setlocale(3C), environ(5).
     chrtbl(1M) in the CX/UX Administrator's Reference Manual.














Page 1                        CX/UX Programmer's Reference Manual