mbtowc

NAME

       mbtowc  -  convert a multibyte character to a wide charac-
       ter.

SYNOPSIS

       #include <stdlib.h>

       int mbtowc(wchar_t *pwc, const char *s, size_t n);

DESCRIPTION

       The mbtowc() function converts a  multibyte  character  s,
       which  is  no  longer  than n bytes, into a wide character
       and, if pwc is not NULL, stores the wide character in pwc.

RETURN VALUE

       mbtowc()  returns  the  number  of  bytes in the multibyte
       character or -1 if the multibyte character is not valid.

CONFORMING TO

       SVID 3, ISO 9899

SEE ALSO

       mblen(3), mbstowcs(3), wcstombs(3), wctomb(3)