_ismbclegal, _ismbclegal_l, _ismbcsymbol, _ismbcsymbol_l
Checks whether a multibyte character is a legal or symbol character.
Important
This API cannot be used in applications that execute in the Windows Runtime. For more information, see CRT functions not supported with /ZW.
int _ismbclegal(
unsigned int c
);
int _ismbclegal_l(
unsigned int c,
_locale_t locale
);
int _ismbcsymbol(
unsigned int c
);
int _ismbcsymbol_l(
unsigned int c,
_locale_t locale
);
Parameters
c
Character to be tested.locale
Locale to use.
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.
Remarks
Each of these functions tests a given multibyte character for a given condition.
The versions of these functions with the _l suffix are identical except that they use the locale passed in instead of the current locale for their locale-dependent behavior. For more information, see Locale.
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 and _MBCS not defined |
_MBCS defined |
_UNICODE defined |
|---|---|---|---|
_istlegal |
Always returns false |
_ismbclegal |
Always returns false. |
_istlegal_l |
Always returns false |
_ismbclegal_l |
Always returns false. |
Requirements
Routine |
Required header |
|---|---|
_ismbclegal,_ismbclegal_l |
<mbstring.h> |
_ismbcsymbol,_ismbcsymbol_l |
<mbstring.h> |
For more compatibility information, see Compatibility.
.NET Framework Equivalent
Not applicable. To call the standard C function, use PInvoke. For more information, see Platform Invoke Examples.