CKTIS / C++
std::tolower — преобразуване в малки букви
std::tolower от <cctype> преобразува един знак в малка буква според текущата C локализация. Преобразувайте стойността от тип char първо в unsigned char и извикайте функцията само ако получената стойност е представима като int.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
#include <cctype>
int std::tolower(int c);std::tolower от <cctype> приема int и връща като int съответната малка буква или непроменената стойност, ако преобразуването не е възможно. Не променя аргумента; запазете резултата.
Аргументът трябва да е равен на EOF или да има стойност, представима като unsigned char. Други стойности водят до неопределено поведение. Обикновеният char може да е отрицателен, затова първо преобразувайте c с static_cast<unsigned char>(c). Извикването std::tolower(static_cast<unsigned char>(c)) е валидно за всяка стойност от тип char, ако UCHAR_MAX <= INT_MAX (и двете константи са достъпни в <climits>). В противен случай преди извикването проверете дали за получената стойност u от тип unsigned char е изпълнено u <= INT_MAX. Ако условието не е изпълнено, обработете стойността, без да извиквате функцията. Преобразуването на стойност извън обхвата на int към типа на параметъра може да даде отрицателна стойност: ако тя не е равна на EOF, поведението е неопределено; ако е равна на EOF, функцията не я третира като знак. Проверете стойност от поток от тип int спрямо EOF, преди да я преобразувате в unsigned char.
Резултатът зависи от текущата C локализация. Това не е преобразуване на главни и малки букви в Unicode или декодиране на UTF-8. Претоварването std::tolower(c, loc) от <locale> е отделно: то използва std::ctype за подадения обект за локализация.
Примерът обработва низ знак по знак и записва всеки резултат като char. Той не проверява обхвата, а приема, че получените след преобразуване в unsigned char стойности са представими като int. Не променя първоначалната C локализация. Не променяйте глобалните настройки чрез std::setlocale едновременно с извиквания на тази функция без синхронизация.
Примери
#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';
}
Резултат
hello, cpp23!
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.