mbstring(3C)         COMPATIBILITY FUNCTIONS         mbstring(3C)



NAME
     mbstring: mbstowcs, wcstombs - multibyte string functions

SYNOPSIS
     #include <stdlib.h>

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

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




















          Last change: C Programming Language Utilities         1