Export (0) Print
Expand All
div
eof
Expand Minimize
This topic has not yet been rated - Rate this topic

_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_l

Tests and converts the case of a multibyte character.

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.

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

Multibyte character to convert.

locale

Locale to use.

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

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; 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 calledjtolower, and _mbctoupper was called jtoupper. For new code, use the new names instead.

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

Routines

Required header

_mbctolower,_mbctolower_l

<mbstring.h>

_mbctoupper,_mbctoupper_l

<mbstring.h>

For more compatibility information, see Compatibility in the Introduction.

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.