_ismbclower, _ismbclower_l, _ismbcupper, _ismbcupper_l
The latest version of this topic can be found at _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 with /ZW.
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 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. 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. |
Requirements
Routine | Required header |
---|---|
_ismbclower |
<mbstring.h> |
_ismbclower_l |
<mbstring.h> |
_ismbcupper |
<mbstring.h> |
_ismbcupper_l |
<mbstring.h> |
For more compatibility information, see Compatibility.
.NET Framework Equivalent
See Also
Character Classification
_ismbc Routines
Locale
Interpretation of Multibyte-Character Sequences
is, isw Routines
_ismbb Routines