CKTIS / C++
std::tolower — conversión a minúsculas
std::tolower de <cctype> convierte un carácter a minúscula según la configuración regional C actual. Si el dato es de tipo char, conviértelo primero a unsigned char y llama a la función solo si el valor resultante es representable como int.
Versión: C++23; repository compiler flag, production runtime not attested
Sintaxis
#include <cctype>
int std::tolower(int c);std::tolower de <cctype> recibe un int y devuelve como int el equivalente en minúscula o el mismo valor si no es posible convertirlo. No modifica el argumento; guarda el resultado.
El argumento debe ser igual a EOF o tener un valor representable como unsigned char. Cualquier otro valor provoca comportamiento indefinido. Un char normal puede ser negativo, así que convierte primero c con static_cast<unsigned char>(c). La llamada std::tolower(static_cast<unsigned char>(c)) es válida para cualquier valor de tipo char si UCHAR_MAX <= INT_MAX (ambas constantes están disponibles en <climits>). De lo contrario, comprueba antes de la llamada que el valor u de tipo unsigned char obtenido cumple u <= INT_MAX. Si no lo cumple, trata ese valor sin llamar a la función. Al convertir un valor fuera del rango de int al tipo del parámetro se puede obtener un valor negativo: si no es EOF, el comportamiento es indefinido; si es EOF, la función no lo trata como un carácter. Comprueba que un valor de flujo de tipo int no sea EOF antes de convertirlo a unsigned char.
El resultado depende de la configuración regional C actual. Esto no es una conversión de mayúsculas y minúsculas Unicode ni una decodificación de UTF-8. La sobrecarga std::tolower(c, loc) de <locale> es distinta: utiliza std::ctype para el objeto de configuración regional proporcionado.
El ejemplo procesa una cadena carácter por carácter y guarda cada resultado como char. No comprueba el rango: da por supuesto que los valores obtenidos al convertir a unsigned char son representables como int. No cambia la configuración regional C inicial. No cambies la configuración global mediante std::setlocale a la vez que se llama a esta función sin sincronización.
Ejemplos
#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!
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.