_ismbclower, _ismbclower_l, _ismbcupper, _ismbcupper_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 _ismbclower, _ismbclower_l, _ismbcupper, _ismbcupper_l.
Checks whether a multibyte character is lowercase or uppercase.
This API cannot be used in applications that execute in the Windows Runtime. For more information, see CRT functions not supported with /ZW. |
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.
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 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. |
| Routine | Required header |
|---|---|
_ismbclower | <mbstring.h> |
_ismbclower_l | <mbstring.h> |
_ismbcupper | <mbstring.h> |
_ismbcupper_l | <mbstring.h> |
For more compatibility information, see Compatibility.
Character Classification
_ismbc Routines
Locale
Interpretation of Multibyte-Character Sequences
is, isw Routines
_ismbb Routines