CKTIS / C++
std::tolower — pretvorba u mala slova
std::tolower iz <cctype> pretvara jedan znak u malo slovo prema trenutačnim C-lokalnim postavkama. Vrijednost tipa char najprije pretvorite u unsigned char i pozovite funkciju samo ako se dobivena vrijednost može prikazati tipom int.
Verzija: C++23; repository compiler flag, production runtime not attested
Sintaksa
#include <cctype>
int std::tolower(int c);std::tolower iz <cctype> prima int i vraća odgovarajuće malo slovo kao int ili nepromijenjenu vrijednost ako pretvorba nije moguća. Ne mijenja argument; spremite rezultat.
Argument mora biti jednak EOF ili imati vrijednost koja se može prikazati kao unsigned char. Druge vrijednosti uzrokuju nedefinirano ponašanje. Običan char može biti negativan, pa c najprije pretvorite pomoću static_cast<unsigned char>(c). Poziv std::tolower(static_cast<unsigned char>(c)) valjan je za svaku vrijednost tipa char ako vrijedi UCHAR_MAX <= INT_MAX (obje su konstante dostupne u <climits>). U suprotnom prije poziva provjerite vrijedi li u <= INT_MAX za dobivenu vrijednost u tipa unsigned char. Ako uvjet nije ispunjen, obradite vrijednost bez pozivanja funkcije. Pretvorba vrijednosti izvan raspona tipa int u tip parametra može dati negativnu vrijednost: ako nije jednaka EOF, ponašanje je nedefinirano; ako je jednaka EOF, funkcija je ne obrađuje kao znak. Vrijednost tipa int iz toka provjerite prema EOF prije pretvorbe u unsigned char.
Rezultat ovisi o trenutačnim C-lokalnim postavkama. Ovo nije pretvorba velikih i malih slova Unicode niti dekodiranje UTF-8. Preopterećenje std::tolower(c, loc) iz <locale> zasebno je: koristi std::ctype za predani objekt lokalnih postavki.
Primjer obrađuje niz znak po znak i svaki rezultat sprema kao char. Ne provjerava raspon: pretpostavlja da se vrijednosti dobivene pretvorbom u unsigned char mogu prikazati tipom int. Ne mijenja početne C-lokalne postavke. Ne mijenjajte globalne postavke putem std::setlocale istodobno s pozivima ove funkcije bez sinkronizacije.
Primjeri
#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';
}
Rezultat
hello, cpp23!
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.