std::toupper

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

文字處理庫

本地化庫

正則表示式庫 (C++11)

格式化庫 (C++20)

空終止序列工具

位元組字串

多位元組字串

寬字串

原生數值轉換

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

文字編碼標識

text_encoding (C++26)

 

空終止位元組字串

函式
字元分類
isalnum isalpha islower isupper isdigit isxdigit	isblank (C++11) iscntrl isgraph isspace isprint ispunct
字元操作
tolower	toupper
轉換為數字格式
atof atoiatolatoll (C++11) strtolstrtoll (C++11)	strtoulstrtoull (C++11) strtofstrtodstrtold (C++11)(C++11) strtoimaxstrtouimax (C++11)(C++11)
字串操作
strcpy strncpy strxfrm	strcat strncat
字串檢查
strlen strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtok
字元陣列函式
memchr memcmp memset	memcpy memmove
雜項
strerror

 

在標頭檔案 <cctype> 中定義
int toupper( int ch );

根據當前安裝的 C 語言環境定義的字元轉換規則，將給定字元轉換為大寫。

在預設的 "C" 語言環境中，以下小寫字母 abcdefghijklmnopqrstuvwxyz 將被替換為相應的大寫字母 ABCDEFGHIJKLMNOPQRSTUVWXYZ。

引數

ch

-

要轉換的字元。如果 ch 的值不能表示為 unsigned char 且不等於 EOF，則行為未定義。

返回值

轉換後的字元，如果當前 C 語言環境未定義大寫版本，則為 ch。

注意

與 <cctype> 中的所有其他函式一樣，如果引數的值既不能表示為 unsigned char 也不等於 EOF，則 std::toupper 的行為未定義。為了安全地將這些函式與普通 char（或 signed char）一起使用，引數應首先轉換為 unsigned char

char my_toupper(char ch)
{
    return static_cast<char>(std::toupper(static_cast<unsigned char>(ch)));
}

同樣，當迭代器值型別為 char 或 signed char 時，它們不應直接與標準演算法一起使用。相反，應首先將值轉換為 unsigned char

std::string str_toupper(std::string s)
{
    std::transform(s.begin(), s.end(), s.begin(),
                // static_cast<int(*)(int)>(std::toupper)         // wrong
                // [](int c){ return std::toupper(c); }           // wrong
                // [](char c){ return std::toupper(c); }          // wrong
                   [](unsigned char c){ return std::toupper(c); } // correct
                  );
    return s;
}

示例

執行此程式碼

#include <cctype>
#include <climits>
#include <clocale>
#include <iostream>
#include <ranges>
 
int main()
{
    for (auto bd{0}; unsigned char lc : std::views::iota(0, UCHAR_MAX))
        if (unsigned char uc = std::toupper(lc); uc != lc)
            std::cout << lc << uc << (13 == ++bd ? '\n' : ' ');
    std::cout << "\n\n";
 
    unsigned char c = '\xb8'; // the character ž in ISO-8859-15
                              // but ¸ (cedilla) in ISO-8859-1
 
    std::setlocale(LC_ALL, "en_US.iso88591");
    std::cout << std::hex << std::showbase;
    std::cout << "in iso8859-1, toupper('0xb8') gives " << std::toupper(c) << '\n';
    std::setlocale(LC_ALL, "en_US.iso885915");
    std::cout << "in iso8859-15, toupper('0xb8') gives " << std::toupper(c) << '\n';
}

輸出

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

另請參閱

tolower	將字元轉換為小寫 (函式)
tolower(std::locale)	使用區域設定的 ctype 刻面將字元轉換為大寫 (函式模板)
towupper	將寬字元轉換為大寫 (函式)
C 文件 用於 toupper

外部連結

1.	ISO/IEC 8859-1。來自維基百科。
2.	ISO/IEC 8859-15。來自維基百科。