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.