C Language and Libraries Help (clang.hlp) (Table of Contents; Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
mbtowc, _fmbtowc
 Summary Example                         Up Contents Index Back
─────Run-Time Library───────────────────────────────────────────────────────
 
     The mbtowc function converts <count> or fewer bytes pointed to by
     <mbchar>, if <mbchar> is not NULL, to a corresponding wide
     character that is determined by the current locale. It stores the
     resulting wide character at <wchar>, if <wchar> is not NULL. It
     will not examine more than MB_CUR_MAX bytes.
 
     The _fmbtowc function is a model-independent (large-model) form of
     the mbtowc function.
 
     Return Value
 
     If <mbchar> is not NULL and if the object that <mbchar> points to
     forms a valid multibyte character, both mbtowc and _fmbtowc return
     the length in bytes of the 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.
                                    -♦-