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: 待定)

• 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++ 文件 關於 toupper