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 character 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 character, if any. 

SEE ALSO

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

CX/UX Programmer’s Reference Manual