std::tolower

 

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 tolower( int ch );

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

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

引數

ch

-

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

返回值

ch 的小寫版本，如果當前 C 語言環境中沒有列出小寫版本，則為未修改的 ch。

注意

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

char my_tolower(char ch)
{
    return static_cast<char>(std::tolower(static_cast<unsigned char>(ch)));
}

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

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

示例

執行此程式碼

#include <cctype>
#include <clocale>
#include <iostream>
 
int main()
{
    unsigned char c = '\xb4'; // the character Ž in ISO-8859-15
                              // but ´ (acute accent) in ISO-8859-1
 
    std::setlocale(LC_ALL, "en_US.iso88591");
    std::cout << std::hex << std::showbase;
    std::cout << "in iso8859-1, tolower('0xb4') gives " << std::tolower(c) << '\n';
    std::setlocale(LC_ALL, "en_US.iso885915");
    std::cout << "in iso8859-15, tolower('0xb4') gives " << std::tolower(c) << '\n';
}

可能的輸出

in iso8859-1, tolower('0xb4') gives 0xb4
in iso8859-15, tolower('0xb4') gives 0xb8

另請參閱

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

外部連結

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