MBSTRING(3C-SVR4)   RISC/os Reference Manual    MBSTRING(3C-SVR4)



NAME
     mbstring: mbstowcs, wcstombs - multibyte string functions

SYNOPSIS
     #include <stdlib.h>

     sizet mbstowcs (wchart *pwcs, const char *s, sizet n);

     sizet wcstombs (char *s, const wchart *pwcs, sizet 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 System Administrator's Reference Manual.




















                        Printed 11/19/92                   Page 1