测试和转换多字节字符的大小写形式。
重要
此 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> |
有关兼容性的详细信息,请参阅 兼容性。
另请参阅
数据转换
%>
%>