Converts a multibyte character to its wide-character equivalent.

    Format

      #include  <stdlib.h>

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