toupper、_toupper、towupper、_toupper_l、_towupper_l
要转换为大写的字符。
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。
没有保留任何返回值以指示错误。
为了使 toupper 可以提供预期结果、__isascii 和 isupper 必须同时非零返回。
备注
如果可能且合适,每个这些例程中转换一个特定小字母转换为大写字母。 towupper 的用例转换特定于区域设置。 在用例中仅与当前区域设置相关的字符被更改。 没有 _l 后缀的函数使用当前设置的区域设置。 这些函数的版本有 _l 后缀将区域设置作为参数并使用它们来代替当前设置的区域设置。 有关详细信息,请参阅区域设置。
为了使 toupper 可以提供预期结果、__isascii 和 isupper 必须同时非零返回。
一般文本例程映射
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> |
有关其他兼容性信息,请参见“简介”中的兼容性。
示例
参见 指向函数的示例。