CKTIS / C++
std::tolower — zamiana na małą literę
std::tolower z <cctype> zamienia pojedynczy znak na małą literę według bieżących ustawień regionalnych C. Wartość znaku typu char najpierw przekształć na unsigned char i przekaż ją do funkcji tylko wtedy, gdy mieści się w zakresie int.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#include <cctype>
int std::tolower(int c);std::tolower z <cctype> przyjmuje int i zwraca jako int odpowiednik małej litery albo niezmienioną wartość, jeśli zamiana nie jest możliwa. Nie modyfikuje argumentu; zapisz wynik.
Argument musi być równy EOF lub mieć wartość reprezentowalną przez unsigned char. Inne wartości powodują niezdefiniowane zachowanie. Zwykły char może mieć wartość ujemną, więc najpierw przekształć c za pomocą static_cast<unsigned char>(c). Wywołanie std::tolower(static_cast<unsigned char>(c)) jest poprawne dla dowolnego c typu char, jeśli UCHAR_MAX <= INT_MAX (obie stałe są dostępne w <climits>). W przeciwnym razie dla uzyskanej wartości u sprawdź u <= INT_MAX przed wywołaniem; jeśli warunek nie jest spełniony, obsłuż tę wartość bez wywoływania funkcji. Konwersja wartości spoza zakresu int na typ parametru może dać ujemną wartość: jeśli jest różna od EOF, zachowanie jest niezdefiniowane, a jeśli jest równa EOF, funkcja nie potraktuje jej jako znaku. Wartość ze strumienia typu int sprawdzaj względem EOF przed konwersją do unsigned char.
Wynik zależy od bieżących ustawień regionalnych C. To nie jest mechanizm zamiany wielkości liter Unicode ani dekodowania UTF-8. Przeciążenie std::tolower(c, loc) z <locale> jest odrębne: korzysta z std::ctype dla podanego obiektu locale.
Przykład przetwarza napis znak po znaku i zapisuje wynik jako char. Nie sprawdza zakresu: zakłada, że wartości po konwersji do unsigned char mieszczą się w int. Nie zmienia początkowych ustawień regionalnych C. Nie zmieniaj globalnych ustawień przez std::setlocale równolegle z wywołaniami tej funkcji bez synchronizacji.
Przykłady
#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';
}
Wynik
hello, cpp23!
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.