_ismbclegal, _ismbclegal_l, _ismbcsymbol, _ismbcsymbol_l

Article
12/18/2017

The latest version of this topic can be found at _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.

Syntax

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.