toupper

 

C

编译器支持

语言

头文件

类型支持

程序工具

可变参数函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

字符串库

空终止字节字符串

空终止多字节字符串

空终止宽字符串

 

空终止字节字符串

函数
字符操作
isalnum isalpha islower isupper isdigit isxdigit isblank (C99)	iscntrl isgraph isspace isprint ispunct tolower toupper
数值格式之间和与数值格式之间的转换
atoiatolatoll (C99) atof strtolstrtoll (C99) strtoulstrtoull (C99)	strtoimaxstrtoumax (C99)(C99) strtofstrtodstrtold (C99)(C99) strfromfstrfromdstrfroml (C23)(C23)(C23)
字符串操作
strcpystrcpy_s (C11) strncpystrncpy_s (C11) strcatstrcat_s (C11)	strncatstrncat_s (C11) strxfrm strdup (C23) strndup (C23)
字符串检查
strlenstrnlen_s (C11) strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtokstrtok_s (C11)
内存操作
memchr memcmp memsetmemset_explicitmemset_s (C23)(C11)	memcpymemcpy_s (C11) memmovememmove_s (C11) memccpy (C23)
杂项
strerrorstrerror_sstrerrorlen_s (C11)(C11)

 

定义于头文件 <ctype.h>
int toupper( int ch );

根据当前安装的 C 语言环境定义的字符转换规则，将给定字符转换为大写。

在默认的 "C" 语言环境中，以下小写字母 abcdefghijklmnopqrstuvwxyz 会被替换为相应的大写字母 ABCDEFGHIJKLMNOPQRSTUVWXYZ。

参数

ch

-

要转换的字符。如果 ch 的值不能表示为 unsigned char 且不等于 EOF，则行为未定义。

返回值

字符 ch 的大写版本，或者如果当前 C 语言环境中未列出大写版本，则返回未修改的 ch。

示例

运行此代码

#include <ctype.h>
#include <limits.h>
#include <locale.h>
#include <stdio.h>
 
int main(void)
{
    // in the default locale:
    for (unsigned char l = 0, u; l != UCHAR_MAX; ++l)
        if ((u = toupper(l)) != l)
            printf("%c%c ", l, u);
    printf("\n\n");
 
    unsigned char c = '\xb8'; // the character ž in ISO-8859-15
                              // but ¸ (cedilla) in ISO-8859-1
    setlocale(LC_ALL, "en_US.iso88591");
    printf("in iso8859-1, toupper('0x%x') gives 0x%x\n", c, toupper(c));
    setlocale(LC_ALL, "en_US.iso885915");
    printf("in iso8859-15, toupper('0x%x') gives 0x%x\n", c, toupper(c));
}

可能的输出

aA bB cC dD eE fF gG hH iI jJ kK lL mM nN oO pP qQ rR sS tT uU vV wW xX yY zZ
 
in iso8859-1, toupper('0xb8') gives 0xb8
in iso8859-15, toupper('0xb8') gives 0xb4

参考文献

• C23 标准 (ISO/IEC 9899:2024)

• 7.4.2.2 toupper 函数 (页码: 待定)

• C17 标准 (ISO/IEC 9899:2018)

• 7.4.2.2 toupper 函数 (页码: 147-148)

• C11 标准 (ISO/IEC 9899:2011)

• 7.4.2.2 toupper 函数 (页码: 204)

• C99 标准 (ISO/IEC 9899:1999)

• 7.4.2.2 toupper 函数 (页码: 185)

• C89/C90 标准 (ISO/IEC 9899:1990)

• 4.3.2.2 toupper 函数

参见

tolower	将字符转换为小写 (函数)
towupper (C95)	将宽字符转换为大写 (函数)
C++ 文档 关于 toupper