Linux程序员手册 第3部分
更新日期： 2017-09-15

名称

towupper，towupper_l-将宽字符转换为大写

语法

#include <wctype.h>

wint_t towupper(wint_t wc);

wint_t towupper_l(wint_t wc, locale_t locale);

glibc的功能测试宏要求(请参阅feature_test_macros(7))：

towupper_l()：

Since glibc 2.10:

_XOPEN_SOURCE>= 700

Before glibc 2.10:

_GNU_SOURCE

说明

towupper()函数与toupper(3)函数的宽字符等效。如果wc是一个小写的宽字符，并且在当前语言环境中存在一个大写等效项，则它将返回wc的一个大写等效项。在所有其他情况下，wc均保持不变。

towupper_l()函数执行相同的任务，但是根据语言环境指定的语言环境中的字符类型信息执行转换。如果语言环境是特殊语言环境对象LC_GLOBAL_LOCALE(请参见duplocale(3))或不是有效的语言环境对象句柄，则towupper_l()的行为是不确定的。

参数wc必须可表示为wchar_t，并且在语言环境中为有效字符或为值WEOF。

返回值

如果wc可转换为大写，则towupper()返回其大写形式；否则返回wc。

版本

towupper_l()函数首先出现在glibc 2.3中。

属性

有关本节中使用的术语的说明，请参见attribute(7)。

遵循规范

towupper()：C99，POSIX.1-2001(XSI)；在POSIX.1-2008中作为XSI扩展名出现，但标记为过时。

towupper_l()：POSIX.1-2008。

备注

这些功能的行为取决于语言环境的LC_CTYPE类别。

这些函数不适用于处理Unicode字符，因为Unicode知道三种情况：大写，小写和标题大小写。

另外参见

iswupper(3)，towctrans(3)，towlower(3)，locale(7)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本，请访问https://www.kernel.org/doc/man-pages/。