_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_l

Tests and converts the case of a multibyte character.

unsigned int _mbctolower(
   unsigned int c 
);
unsigned int _mbctolower_l(
   unsigned int c,
   _locale_t locale
);
unsigned int _mbctoupper(
   unsigned int c 
);
unsigned int _mbctoupper_l(
   unsigned int c,
   _locale_t locale
);

Parameters

• c
  Multibyte character to convert.

• locale
  Locale to use.

Return Value

Each of these functions returns the converted character c, if possible. Otherwise it returns the character c unchanged.

Remarks

The functions test a character c and, if possible, apply one of the following conversions.

The output value is affected by the setting of the LC_CTYPE category setting of the locale; see setlocale for more information. The version of this function without the _l suffix uses the current locale for this locale-dependent behavior; the version with the _l suffix is identical except that it uses the locale parameter passed in instead. For more information, see Locale.

In previous versions, _mbctolower was called jtolower, and _mbctoupper was called jtoupper. For new code, use the new names instead.

Generic-Text Routine Mappings

Requirements

For more compatibility information, see Compatibility in the Introduction.

See Also

Concepts

Data Conversion

_mbbtombc, _mbbtombc_l

_mbcjistojms, _mbcjistojms_l, _mbcjmstojis, _mbcjmstojis_l

_mbctohira, _mbctohira_l, _mbctokata, _mbctokata_l

_mbctombb, _mbctombb_l