Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori