CKTIS / C++
std::tolower — omzetten naar kleine letters
std::tolower uit <cctype> zet één teken om naar een kleine letter volgens de huidige C-locale. Zet een char-waarde eerst om naar unsigned char en roep de functie alleen aan als de resulterende waarde in int past.
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
#include <cctype>
int std::tolower(int c);std::tolower uit <cctype> neemt een int en geeft als int de overeenkomstige kleine letter terug, of dezelfde waarde als omzetten niet mogelijk is. De functie wijzigt het argument niet; sla het resultaat op.
Het argument moet gelijk zijn aan EOF of een waarde hebben die als unsigned char kan worden weergegeven. Andere waarden veroorzaken ongedefinieerd gedrag. Een gewone char kan negatief zijn, dus zet c eerst om met static_cast<unsigned char>(c). De aanroep std::tolower(static_cast<unsigned char>(c)) is geldig voor elke char-waarde als UCHAR_MAX <= INT_MAX (beide constanten zijn beschikbaar in <climits>). Controleer anders vóór de aanroep of voor de verkregen unsigned char-waarde u geldt dat u <= INT_MAX. Zo niet, verwerk die waarde dan zonder de functie aan te roepen. Bij omzetting van een waarde buiten het bereik van int naar het parametertype kan een negatieve waarde ontstaan: als die niet gelijk is aan EOF, is het gedrag ongedefinieerd; als die wel gelijk is aan EOF, behandelt de functie die niet als teken. Controleer bij een int-waarde uit een stream eerst of deze EOF is voordat je omzet naar unsigned char.
Het resultaat hangt af van de huidige C-locale. Dit is geen Unicode-omzetting van hoofdletters naar kleine letters en geen UTF-8-decodering. De overload std::tolower(c, loc) uit <locale> is hiervan onderscheiden: deze gebruikt std::ctype voor het opgegeven locale-object.
Het voorbeeld verwerkt een tekenreeks teken voor teken en slaat elk resultaat op als char. Het controleert het bereik niet, maar gaat ervan uit dat de waarden na omzetting naar unsigned char in int passen. De aanvankelijke C-locale blijft ongewijzigd. Wijzig globale instellingen via std::setlocale niet tegelijk met aanroepen van deze functie, tenzij je synchronisatie toepast.
Voorbeelden
#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';
}
Resultaat
hello, cpp23!
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.