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 函数 (p: TBD)

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

• 7.4.2.2 toupper 函数 (p: 147-148)

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

• 7.4.2.2 toupper 函数 (p: 204)

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

• 7.4.2.2 toupper 函数 (p: 185)

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

• 4.3.2.2 toupper 函数

另请参阅

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