将字符转换为大写。
语法
int toupper(
int c
);
int _toupper(
int c
);
int towupper(
wint_t c
);
int _toupper_l(
int c ,
_locale_t locale
);
int _towupper_l(
wint_t c ,
_locale_t locale
);
参数
c
要转换的字符。
locale
要使用的区域设置。
返回值
如果可行，则其中的各个例程将转换 c 的副本，并返回结果。
如果 c 是 iswlower 为非零值的宽字符并且有 iswupper 为非零值的对应宽字符，则 towupper 返回对应的宽字符；否则，towupper 返回未改变的 c。
没有保留返回值来指示错误。
注解
如果可行且恰当，则其中的各个例程将指定小写字母转换为大写字母。 towupper 的大小写转换是特定于区域设置的。 只改变与当前区域设置相关的字符的大小写。 没有 _l 后缀的函数使用当前设置的区域设置。 这些带有 _l 后缀的函数的版本将区域设置用作参数并使用它，而不是使用当前设置的区域设置。 有关详细信息，请参阅 Locale。
要使 toupper 提供预期结果，__isascii 必须返回非零值。
默认情况下，此函数的全局状态范围限定为应用程序。 若要更改此行为，请参阅 CRT 中的全局状态。
一般文本例程映射
TCHAR.H 例程 |
_UNICODE 和 _MBCS 未定义 |
_MBCS 已定义 |
_UNICODE 已定义 |
|---|---|---|---|
_totupper |
toupper |
_mbctoupper |
towupper |
_totupper_l |
_toupper_l |
_mbctoupper_l |
_towupper_l |
注意
_toupper_l 和 _towupper_l 没有区域设置相关性，并且不应直接调用。 它们供 _totupper_l 内部使用。
要求
| 例程 | 必需的标头 |
|---|---|
toupper |
<ctype.h> |
_toupper |
<ctype.h> |
towupper |
<ctype.h> 或 <wchar.h> |
有关兼容性的详细信息，请参阅 兼容性。
示例
请参阅 to 函数中的示例。