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 可以提供预期结果、__isasciiisupper 必须同时非零返回。

备注

如果可能且合适,每个这些例程中转换一个特定小字母转换为大写字母。 towupper 的用例转换特定于区域设置。 在用例中仅与当前区域设置相关的字符被更改。 没有 _l 后缀的函数使用当前设置的区域设置。 这些函数的版本有 _l 后缀将区域设置作为参数并使用它们来代替当前设置的区域设置。 有关详细信息,请参阅区域设置

为了使 toupper 可以提供预期结果、__isasciiisupper 必须同时非零返回。

数据转换例程

一般文本例程映射

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>

有关其他兼容性信息,请参见“简介”中的兼容性

示例

参见 指向函数的示例。

.NET Framework 等效项

System::Char::ToUpper

请参见

参考

is、isw 例程

to 函数

区域设置

多字节字符序列的解释