_ismbclower
, _ismbclower_l
, _ismbcupper
, _ismbcupper_l
Checks whether a multibyte character is lowercase or uppercase.
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 _ismbclower(
unsigned int c
);
int _ismbclower_l(
unsigned int c,
_locale_t locale
);
int _ismbcupper(
unsigned int c
);
int _ismbcupper_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 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 |
---|---|---|
_ismbclower |
Lowercase alphabetic | Returns nonzero if and only if c is a single-byte representation of an ASCII lowercase English letter: 0x61<=c <=0x7A. |
_ismbclower_l |
Lowercase alphabetic | Returns nonzero if and only if c is a single-byte representation of an ASCII lowercase English letter: 0x61<=c <=0x7A. |
_ismbcupper |
Uppercase alphabetic | Returns nonzero if and only if c is a single-byte representation of an ASCII uppercase English letter: 0x41<=c <=0x5A. |
_ismbcupper_l |
Uppercase alphabetic | Returns nonzero if and only if c is a single-byte representation of an ASCII uppercase English letter: 0x41<=c <=0x5A. |
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 |
---|---|
_ismbclower |
<mbstring.h> |
_ismbclower_l |
<mbstring.h> |
_ismbcupper |
<mbstring.h> |
_ismbcupper_l |
<mbstring.h> |
For more compatibility information, see Compatibility.
See also
Character classification
_ismbc
routines
Locale
Interpretation of multibyte-character sequences
is
, isw
routines
_ismbb
routines