CKTIS / C++
std::tolower — Umwandlung in Kleinbuchstaben
std::tolower aus <cctype> wandelt ein einzelnes Zeichen entsprechend der aktuellen C-Locale in einen Kleinbuchstaben um. Wandle char zuerst in unsigned char um und rufe die Funktion nur auf, wenn der resultierende Wert als int darstellbar ist.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <cctype>
int std::tolower(int c);std::tolower aus <cctype> nimmt einen int entgegen und gibt den entsprechenden Kleinbuchstaben ebenfalls als int zurück. Ist keine Umwandlung möglich, bleibt der Wert unverändert. Das Argument wird nicht geändert; speichere den Rückgabewert.
Das Argument muss EOF entsprechen oder einen Wert haben, der als unsigned char darstellbar ist. Andere Werte führen zu undefiniertem Verhalten. Ein gewöhnliches char kann negativ sein; wandle c deshalb zuerst mit static_cast<unsigned char>(c) um. Der Aufruf std::tolower(static_cast<unsigned char>(c)) ist für jeden char-Wert gültig, wenn UCHAR_MAX <= INT_MAX gilt (beide Konstanten sind in <climits> verfügbar). Prüfe andernfalls vor dem Aufruf für den resultierenden unsigned char-Wert u, ob u <= INT_MAX gilt. Ist das nicht der Fall, behandle den Wert ohne Aufruf der Funktion. Bei der Umwandlung eines außerhalb des Wertebereichs liegenden Werts in den Parametertyp int kann ein negativer Wert entstehen: Ist er ungleich EOF, ist das Verhalten undefiniert; ist er gleich EOF, behandelt die Funktion ihn nicht als Zeichen. Prüfe einen int-Wert aus einem Stream auf EOF, bevor du ihn in unsigned char umwandelst.
Das Ergebnis hängt von der aktuellen C-Locale ab. Die Funktion führt weder Unicode-Groß-/Kleinschreibungsumwandlung noch UTF-8-Dekodierung durch. Die Überladung std::tolower(c, loc) aus <locale> ist davon getrennt: Sie verwendet std::ctype für das übergebene Locale-Objekt.
Das Beispiel verarbeitet einen String Zeichen für Zeichen und speichert jedes Ergebnis als char. Es prüft den Wertebereich nicht, sondern setzt voraus, dass die nach unsigned char umgewandelten Werte als int darstellbar sind. Es ändert die anfängliche C-Locale nicht. Ändere globale Einstellungen über std::setlocale nicht gleichzeitig mit Aufrufen dieser Funktion, sofern keine Synchronisierung erfolgt.
Beispiele
#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';
}
Ergebnis
hello, cpp23!
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.