Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes