CKTIS / C++
std::tolower — prevod na malé písmená
std::tolower z <cctype> prevádza jeden znak na malé písmeno podľa aktuálneho prostredia C. Hodnotu typu char najprv preveďte na unsigned char a funkciu volajte len vtedy, ak je výsledná hodnota reprezentovateľná v type int.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
#include <cctype>
int std::tolower(int c);std::tolower z <cctype> prijíma int a vracia ako int zodpovedajúce malé písmeno alebo nezmenenú hodnotu, ak prevod nie je možný. Argument nemení; výsledok uložte.
Argument sa musí rovnať EOF alebo mať hodnotu reprezentovateľnú ako unsigned char. Iné hodnoty spôsobujú nedefinované správanie. Obyčajný char môže byť záporný, preto najprv preveďte c pomocou static_cast<unsigned char>(c). Volanie std::tolower(static_cast<unsigned char>(c)) je platné pre každú hodnotu typu char, ak platí UCHAR_MAX <= INT_MAX (obe konštanty sú dostupné v <climits>). Inak pred volaním overte, že pre získanú hodnotu u typu unsigned char platí u <= INT_MAX. Ak podmienka neplatí, spracujte hodnotu bez volania funkcie. Prevodom hodnoty mimo rozsahu typu int na typ parametra môže vzniknúť záporná hodnota: ak sa nerovná EOF, správanie je nedefinované; ak sa rovná EOF, funkcia ju nepovažuje za znak. Pri hodnote typu int zo streamu pred prevodom na unsigned char skontrolujte, či sa nerovná EOF.
Výsledok závisí od aktuálneho prostredia C. Nejde o prevod veľkosti písmen Unicode ani o dekódovanie UTF-8. Preťaženie std::tolower(c, loc) z <locale> je samostatné: používa std::ctype pre zadaný objekt prostredia.
Príklad spracúva reťazec znak po znaku a každý výsledok ukladá ako char. Rozsah nekontroluje: predpokladá, že hodnoty získané prevodom na unsigned char sa zmestia do typu int. Počiatočné prostredie C nemení. Nemeňte globálne nastavenia pomocou std::setlocale súčasne s volaniami tejto funkcie bez synchronizácie.
Prí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ýsledok
hello, cpp23!
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.