NAME

     mbstowcs - convert a multibyte string to  a  wide  character
     string.


SYNOPSIS

     #include <stdlib.h>

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


DESCRIPTION

     The mbstowcs() function converts  a  sequence  of  multibyte
     characters  from the array s into a sequence of wide charac-
     ters and stores up to n wide characters in the array pwcs.


RETURN VALUE

     mbstowcs() returns the number of wide characters  stored  or
     -1 if s contains an invalid multibyte character.


CONFORMING TO

     SVID 3, ISO 9899


SEE ALSO

     mblen(3), mbtowc(3), wcstombs(3),