_ismbclegal, _ismbcsymbol
Important This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here. ArchiveDisclaimer

_ismbclegal, _ismbcsymbol

int _ismbclegal(
   unsigned int c 
int _ismbcsymbol(
   unsigned int c 


Character to be tested.

Return Value

Each of these routines returns a nonzero value if the character satisfies the test condition or 0 if it does not. If c<= 255 and there is a corresponding _ismbb routine (for example, _ismbcalnum corresponds to _ismbbalnum), the result is the return value of the corresponding _ismbb routine.


Each of these functions tests a given multibyte character for a given condition.

Routine Test condition Code page 932 example
_ismbclegal Valid multibyte Returns nonzero if and only if the first byte of c is within ranges 0x81 – 0x9F or 0xE0 – 0xFC, while the second byte is within ranges 0x40 - 0x7E or 0x80 - FC.
_ismbcsymbol Multibyte symbol Returns nonzero if and only if 0x8141<=c<=0x81AC.

Generic-Text Routine Mappings

TCHAR.H routine _UNICODE & _MBCS not defined _MBCS defined _UNICODE defined
_istlegal Always returns false _ismbclegal Always returns false.


Routine Required header Compatibility
_ismbclegal <mbstring.h> Win 98, Win Me, Win NT, Win 2000, Win XP
_ismbcsymbol <mbstring.h> Win 98, Win Me, Win NT, Win 2000, Win XP

For additional compatibility information, see Compatibility in the Introduction.


All versions of the C run-time libraries.

See Also

Character Classification Routines | _ismbc Function Overview | is, isw Function Overview | _ismbb Routines | Run-Time Routines and .NET Framework Equivalents

© 2015 Microsoft