This topic has not yet been rated - Rate this topic

_ismbclegal, _ismbclegal_l, _ismbcsymbol, _ismbcsymbol_l

Visual Studio 2005

Checks whether a multibyte character is an legal or symbol character.


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.

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	Compatibility
_ismbclegal,_ismbclegal_l	<mbstring.h>	Windows 95, Windows 98, Windows 98 Second Edition, Windows Millennium Edition, Windows NT 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003
_ismbcsymbol,_ismbcsymbol_l	<mbstring.h>	Windows 95, Windows 98, Windows 98 Second Edition, Windows Millennium Edition, Windows NT 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003

For more compatibility information, see Compatibility in the Introduction.

.NET Framework Equivalent

Not applicable. To call the standard C function, use PInvoke. For more information, see Platform Invoke Examples.

Reference

Character Classification
_ismbc Routines
is, isw Routines
_ismbb Routines

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Additions

ADD