This documentation is archived and is not being maintained.

_ismbclower, _ismbclower_l, _ismbcupper, _ismbcupper_l

Checks whether a multibyte character is lowercase or uppercase.

Important note Important

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
);

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.

Show: