测试和转换多字节字符的大小写形式。
重要
此 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
,如果可能,还将应用以下转换之一。
例程 | 转换 |
---|---|
%> | 大写字符到小写字符。 |
%> | 小写字符到大写字符。 |
输出值受区域设置的 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 |
要求
例程 | 必需的标头 |
---|---|
%> | <mbstring.h> |
%> | <mbstring.h> |
有关兼容性的详细信息,请参阅 兼容性。
另请参阅
数据转换
%>
%>