_ismbcl0, _ismbcl0_l, _ismbcl1, _ismbcl1_l, _ismbcl2, _ismbcl2_l
The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.
The latest version of this topic can be found at _ismbcl0, _ismbcl0_l, _ismbcl1, _ismbcl1_l, _ismbcl2, _ismbcl2_l.
Code Page 932 Specific functions**, using the current locale or a specified LC_CTYPE conversion state category.
This API cannot be used in applications that execute in the Windows Runtime. For more information, see CRT functions not supported with /ZW. |
int _ismbcl0( unsigned int c ); int _ismbcl0_l( unsigned int c, _locale_t locale ); int _ismbcl1( unsigned int c ); int _ismbcl1_l( unsigned int c , _locale_t locale ); int _ismbcl2( unsigned int c ); int _ismbcl2_l( unsigned int c, _locale_t locale );
Parameters
c
Character to be tested.
locale
Locale to use.
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.
The output value is affected by the setting of the LC_CTYPE category setting of the locale; see setlocale for more information. The versions of these functions without the _l suffix use the current locale for this locale-dependent behavior; the versions with the _l suffix are identical except that they use the locale parameter passed in instead. For more information, see Locale.
| Routine | Test condition (code page 932 only) |
|---|---|
_ismbcl0 | JIS non-Kanji: 0x8140<=c<=0x889E. |
_ismbcl0_l | JIS non-Kanji: 0x8140<=c<=0x889E. |
_ismbcl1 | JIS level-1: 0x889F<=c<=0x9872. |
_ismbcl1_l | JIS level-1: 0x889F<=c<=0x9872. |
_ismbcl2 | JIS level-2: 0x989F<=c<=0xEAA4. |
_ismbcl2_l | JIS level-2: 0x989F<=c<=0xEAA4. |
The functions check that the specified value c matches the test conditions described above, but do not check that c is a valid multibyte character. If the lower byte is in the ranges 0x00 – 0x3F, 0x7F, or 0xFD – 0xFF, these functions return a nonzero value, indicating that the character satisfies the test condition. Use _ismbbtrail to test whether the multibyte character is defined.
End Code Page 932 Specific
| Routine | Required header |
|---|---|
_ismbcl0 | <mbstring.h> |
_ismbcl0_l | <mbstring.h> |
_ismbcl1 | <mbstring.h> |
_ismbcl1_l | <mbstring.h> |
_ismbcl2 | <mbstring.h> |
_ismbcl2_l | <mbstring.h> |
For more compatibility information, see Compatibility.
Not applicable. To call the standard C function, use PInvoke. For more information, see Platform Invoke Examples.