Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C++

std::tolower — pretvorba v male črke

std::tolower iz <cctype> pretvori posamezen znak v malo črko v skladu s trenutnimi področnimi nastavitvami C. Vrednost tipa char najprej pretvorite v unsigned char in funkcijo pokličite le, če je dobljeno vrednost mogoče predstaviti s tipom int.

Različica: C++23; repository compiler flag, production runtime not attested

Sintaksa

#include <cctype>
int std::tolower(int c);

std::tolower iz <cctype> sprejme int in vrne ustrezno malo črko kot int ali nespremenjeno vrednost, če pretvorba ni mogoča. Argumenta ne spremeni; rezultat shranite.

Argument mora biti enak EOF ali imeti vrednost, ki jo je mogoče predstaviti kot unsigned char. Druge vrednosti povzročijo nedefinirano vedenje. Navaden char je lahko negativen, zato c najprej pretvorite z static_cast<unsigned char>(c). Klic std::tolower(static_cast<unsigned char>(c)) je veljaven za vse vrednosti tipa char, če velja UCHAR_MAX <= INT_MAX (obe konstanti sta na voljo v <climits>). V nasprotnem primeru pred klicem preverite, ali za dobljeno vrednost u tipa unsigned char velja u <= INT_MAX. Če pogoj ni izpolnjen, vrednost obravnavajte brez klica funkcije. Pri pretvorbi vrednosti zunaj obsega tipa int v tip parametra lahko nastane negativna vrednost: če ni enaka EOF, je vedenje nedefinirano; če je enaka EOF, je funkcija ne obravnava kot znak. Vrednost tipa int iz toka pred pretvorbo v unsigned char preverite glede na EOF.

Rezultat je odvisen od trenutnih področnih nastavitev C. To ni pretvorba velikosti črk Unicode niti dekodiranje UTF-8. Preobremenitev std::tolower(c, loc) iz <locale> je ločena: uporablja std::ctype za podani objekt področnih nastavitev.

Primer obdela niz znak za znakom in vsak rezultat shrani kot char. Obsega ne preverja: predpostavlja, da je vrednosti, dobljene s pretvorbo v unsigned char, mogoče predstaviti s tipom int. Začetnih področnih nastavitev C ne spremeni. Globalnih nastavitev prek std::setlocale ne spreminjajte sočasno s klici te funkcije brez sinhronizacije.

Primeri

#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!

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri