_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.

See also

Character classification
_ismbc routines
is, isw routines