C Language and Libraries Help (clang.hlp) (Table of Contents; Topic list)
mbtowc, _fmbtowc
 Description Example                     Up Contents Index Back
─────Run-Time Library───────────────────────────────────────────────────────
 
  Include:   <stdlib.h>
 
  Syntax:    int mbtowc( wchar_t *wchar, char *mbchar, size_t count );
             int _fmbtowc( wchar_t __far *wchar, char __far *mbchar,
                           size_t count );
 
  Returns:   the length in bytes of the multibyte character if <mbchar> is
             not NULL and if the object that <mbchar> points to forms a
             valid multibyte character. If <mbchar> is NULL or the object
             that it points to is a wide-character null character (L'\0'),
             both functions return 0. If the object that <mbchar> points
             to does not form a valid multibyte character within the first
             <count> characters, they return -1.
 
  See also:  mblen, mbstowcs, wchar_t, wcstombs, wctomb, MB_CUR_MAX,
             MB_LEN_MAX
                                    -♦-