_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.
Important
This API cannot be used in applications that execute in the Windows Runtime. For more information, see CRT functions not supported in Universal Windows Platform apps.
Syntax
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.
Return value
Each of these routines returns a nonzero value if the character satisfies the test condition. Otherwise, they return 0. If c
<= 255 and there's 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 output value is affected by the setting of the LC_CTYPE
category setting of the locale. For more information, see setlocale
. 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 don't 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
By default, this function's global state is scoped to the application. To change this behavior, see Global state in the CRT.
Requirements
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.