This documentation is archived and is not being maintained.

_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