_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_l

测试和转换多字节字符的大小写形式。

重要

此 API 不能用于在 Windows 运行时中执行的应用程序。 有关详细信息，请参阅通用 Windows 平台应用中不支持的 CRT 函数。

语法

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
要转换的多字节字符。

locale
要使用的区域设置。

返回值

如果可能，这些函数将返回转换的字符 c。 否则，它将返回未经任何修改的字符 c。

备注

这些函数将测试一个字符 c，如果可能，还将应用以下转换之一。

例程	转换
_mbctolower，_mbctolower_l	大写字符到小写字符。
_mbctoupper，_mbctoupper_l	小写字符到大写字符。

输出值受区域设置的 LC_CTYPE 类别设置的影响。 有关详细信息，请参阅 setlocale。 此不带 _l 后缀的版本将对与区域设置相关的行为使用当前设置；而带有 _l 后缀的版本也执行相同的操作，只不过它改用传入的区域设置参数。 有关详细信息，请参阅 Locale。

在早期版本中，_mbctolower 称为 jtolower，而 _mbctoupper 称为 jtoupper。 对于新代码，请改用新名称。

默认情况下，此函数的全局状态范围限定为应用程序。 若要更改此行为，请参阅 CRT 中的全局状态。

一般文本例程映射

Tchar.h 例程	_UNICODE 和 _MBCS 未定义	_MBCS 已定义	_UNICODE 已定义
_totlower	tolower	_mbctolower	towlower
_totlower_l	_tolower_l	_mbctolower_l	_towlower_t
_totupper	toupper	_mbctoupper	towupper
_totupper_l	toupper_l	_mbctoupper_l	_towupper_l

要求

例程	必需的标头
_mbctolower，_mbctolower_l	<mbstring.h>
_mbctoupper，_mbctoupper_l	<mbstring.h>

有关兼容性的详细信息，请参阅 兼容性。

另请参阅

数据转换
_mbbtombc、_mbbtombc_l
_mbcjistojms、_mbcjistojms_l、_mbcjmstojis、_mbcjmstojis_l
_mbctohira、_mbctohira_l、_mbctokata、_mbctokata_l
_mbctombb、_mbctombb_l