CKTIS / C++
std::tolower — převod na malá písmena
std::tolower z <cctype> převádí jeden znak na malé písmeno podle aktuálního prostředí C. Hodnotu typu char nejprve převeďte na unsigned char a funkci volejte jen tehdy, pokud je výsledná hodnota reprezentovatelná v typu int.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <cctype>
int std::tolower(int c);std::tolower z <cctype> přijímá int a vrací jako int odpovídající malé písmeno, nebo nezměněnou hodnotu, pokud převod není možný. Argument nemění; výsledek uložte.
Argument se musí rovnat EOF nebo mít hodnotu reprezentovatelnou jako unsigned char. Jiné hodnoty způsobují nedefinované chování. Běžný char může být záporný, proto nejprve převeďte c pomocí static_cast<unsigned char>(c). Volání std::tolower(static_cast<unsigned char>(c)) je platné pro každou hodnotu typu char, pokud platí UCHAR_MAX <= INT_MAX (obě konstanty jsou dostupné v <climits>). Jinak před voláním ověřte, že pro získanou hodnotu u typu unsigned char platí u <= INT_MAX. Pokud podmínka neplatí, zpracujte hodnotu bez volání funkce. Převodem hodnoty mimo rozsah typu int na typ parametru může vzniknout záporná hodnota: pokud se nerovná EOF, je chování nedefinované; pokud se rovná EOF, funkce ji nepovažuje za znak. U hodnoty typu int ze streamu před převodem na unsigned char ověřte, že se nerovná EOF.
Výsledek závisí na aktuálním prostředí C. Nejde o převod velikosti písmen Unicode ani o dekódování UTF-8. Přetížení std::tolower(c, loc) z <locale> je samostatné: používá std::ctype pro předaný objekt prostředí.
Příklad zpracovává řetězec znak po znaku a každý výsledek ukládá jako char. Rozsah nekontroluje: předpokládá, že hodnoty získané převodem na unsigned char se vejdou do typu int. Počáteční prostředí C nemění. Neměňte globální nastavení pomocí std::setlocale současně s voláním této funkce bez synchronizace.
Příklady
#include <cctype>
#include <iostream>
#include <string>
int main() {
std::string text = "Hello, CPP23!";
for (char& c : text) {
c = static_cast<char>(std::tolower(static_cast<unsigned char>(c)));
}
std::cout << text << '\n';
}
Výsledek
hello, cpp23!
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.