Edit

Share via


_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_l

Tests and converts the case of a multibyte character.

Important

This API cannot be used in applications that execute in the Windows Runtime. For more information, see CRT functions not supported in Universal Windows Platform apps.

Syntax

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.

Routines Converts
_mbctolower, _mbctolower_l Uppercase character to lowercase character.
_mbctoupper, _mbctoupper_l Lowercase character to uppercase character.

The output value is affected by the setting of the LC_CTYPE category setting of the locale. For more information, see setlocale. 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.

By default, this function's global state is scoped to the application. To change this behavior, see Global state in the CRT.

Generic-text routine mappings

Tchar.h routine _UNICODE and _MBCS not defined _MBCS defined _UNICODE defined
_totlower tolower _mbctolower towlower
_totlower_l _tolower_l _mbctolower_l _towlower_t
_totupper toupper _mbctoupper towupper
_totupper_l toupper_l _mbctoupper_l _towupper_l

Requirements

Routines Required header
_mbctolower, _mbctolower_l <mbstring.h>
_mbctoupper, _mbctoupper_l <mbstring.h>

For more compatibility information, see Compatibility.

See also

Data conversion
_mbbtombc, _mbbtombc_l
_mbcjistojms, _mbcjistojms_l, _mbcjmstojis, _mbcjmstojis_l
_mbctohira, _mbctohira_l, _mbctokata, _mbctokata_l
_mbctombb, _mbctombb_l