CKTIS / C++
std::tolower — conversão para minúsculas
std::tolower de <cctype> converte um carácter para minúscula de acordo com a locale C atual. Para um valor do tipo char, converta-o primeiro para unsigned char e só chame a função se o valor obtido for representável como int.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#include <cctype>
int std::tolower(int c);std::tolower de <cctype> recebe um int e devolve como int o equivalente em minúscula ou o mesmo valor, caso não seja possível fazer a conversão. Não modifica o argumento; guarde o resultado.
O argumento tem de ser igual a EOF ou ter um valor representável como unsigned char. Outros valores provocam comportamento indefinido. Um char simples pode ser negativo, pelo que deve primeiro converter c com static_cast<unsigned char>(c). A chamada std::tolower(static_cast<unsigned char>(c)) é válida para qualquer valor do tipo char se UCHAR_MAX <= INT_MAX (ambas as constantes estão disponíveis em <climits>). Caso contrário, verifique antes da chamada se o valor u obtido, do tipo unsigned char, satisfaz u <= INT_MAX. Se não satisfizer a condição, trate esse valor sem chamar a função. A conversão de um valor fora do intervalo de int para o tipo do parâmetro pode produzir um valor negativo: se for diferente de EOF, o comportamento é indefinido; se for igual a EOF, a função não o trata como um carácter. Verifique se um valor de fluxo do tipo int é EOF antes de o converter para unsigned char.
O resultado depende da locale C atual. Não se trata de conversão entre maiúsculas e minúsculas Unicode nem de descodificação UTF-8. A sobrecarga std::tolower(c, loc) de <locale> é distinta: usa std::ctype para o objeto locale fornecido.
O exemplo processa uma cadeia carácter a carácter e guarda cada resultado como char. Não verifica o intervalo: pressupõe que os valores obtidos após a conversão para unsigned char são representáveis como int. Não altera a locale C inicial. Não altere as definições globais através de std::setlocale enquanto esta função é chamada, sem sincronização.
Exemplos
#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';
}
Resultado
hello, cpp23!
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.