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

CKTIS / C++

std::toupper — convertir un carácter a mayúscula

std::toupper de <cctype> devuelve el equivalente en mayúscula de un carácter según la configuración regional C actual. El argumento debe ser igual a EOF o poder representarse como unsigned char; el tipo de retorno es int.

Versión: C++23; repository compiler flag, production runtime not attested

Sintaxis

#include <cctype>
int std::toupper(int c);

std::toupper de <cctype> tiene la firma int std::toupper(int c). Devuelve la mayúscula correspondiente según la configuración regional C actual, o el argumento sin cambios si no hay conversión disponible. No modifica el argumento: asigna el resultado o úsalo de otra manera.

El valor que se pasa al parámetro de tipo int debe ser igual a EOF o poder representarse como unsigned char. Cualquier otro valor provoca un comportamiento indefinido. Como un char ordinario puede ser negativo, usa std::toupper(static_cast<unsigned char>(ch)) para una variable de tipo char siempre que el valor obtenido tras la conversión explícita pueda representarse como int. Si int no puede representar todos los valores de unsigned char, comprueba antes de llamar a la función que el valor obtenido cabe en int. De lo contrario, la conversión a int puede producir un valor negativo distinto de EOF y provocar un comportamiento indefinido. Si produce EOF, la función recibe EOF en lugar del valor del carácter. Si una función de entrada devuelve un valor de tipo int, comprueba si es EOF antes de convertirlo a unsigned char.

El ejemplo procesa una cadena carácter por carácter y convierte explícitamente el resultado int de nuevo a char. Da por hecho que todos los valores obtenidos al convertir a unsigned char caben en int. Con la configuración regional inicial "C", la salida esperada es HELLO, C++23! seguido de un salto de línea. Este no es un mecanismo general de conversión entre mayúsculas y minúsculas para Unicode: procesar bytes UTF-8 de esta manera no basta.

No confundas esta función con la sobrecarga std::toupper(c, loc) de <locale>, que utiliza un objeto de configuración regional proporcionado explícitamente. Las indicaciones anteriores sobre la conversión a unsigned char se aplican a la función de un argumento de <cctype>.

Ejemplos

#include <cctype>
#include <iostream>
#include <string>

int main() {
    std::string text = "Hello, C++23!";
    for (char& ch : text) {
        ch = static_cast<char>(
            std::toupper(static_cast<unsigned char>(ch)));
    }
    std::cout << text << '\n';
}

Resultado

HELLO, C++23!

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