_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

• System::Char::IsLower

• System::Char::IsUpper

See Also

Character Classification
_ismbc Routines
Locale
Interpretation of Multibyte-Character Sequences
is, isw Routines
_ismbb Routines