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

CKTIS / C++

std::isalpha — comprobar si un carácter es una letra

std::isalpha de <cctype> comprueba si un valor representa una letra según la configuración regional C actual. Devuelve int: cero o un valor distinto de cero. Para clasificar un valor de tipo char, conviértelo a unsigned char y pasa el resultado solo si se puede representar como int.

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

Sintaxis

#include <cctype>
#include <climits>
// Signature: int std::isalpha(int c);

const auto byte = static_cast<unsigned char>(ch);
if (byte <= INT_MAX) {
    const bool letter = std::isalpha(static_cast<int>(byte)) != 0;
    // Use letter here.
} else {
    // This byte cannot be passed to std::isalpha as its original value.
}

std::isalpha de <cctype> clasifica un único valor de carácter según la categoría LC_CTYPE de la configuración regional C actual. Devuelve int: un valor distinto de cero si es una letra y 0 en caso contrario. Comprueba != 0, no == 1: no se garantiza que un resultado verdadero sea igual a 1.

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. Para una variable char ch, convertirla únicamente a int no corrige un valor negativo de char. Evalúa primero static_cast<unsigned char>(ch). La llamada std::isalpha(static_cast<unsigned char>(ch)) es segura para cualquier ch si UCHAR_MAX <= INT_MAX. Si UCHAR_MAX > INT_MAX, comprueba que el valor obtenido no supere INT_MAX antes de convertirlo a int (ambos límites se definen en <climits>). Un valor superior a INT_MAX no se puede pasar sin alterarlo: la conversión puede dar EOF u otro valor negativo que provoque un comportamiento indefinido. No llames a la función para un byte de ese tipo. Mantén como int el resultado de una función de entrada que devuelva int y comprueba si es EOF antes de convertir el byte.

En la configuración regional "C", las letras son A–Z y a–z; otras configuraciones pueden reconocer letras adicionales. La función no decodifica UTF-8: clasificar bytes individuales no permite determinar si un carácter Unicode multibyte es una letra.

No confundas esta función con std::isalpha(ch, loc), de dos argumentos y perteneciente a <locale>, que devuelve bool y utiliza un objeto de configuración regional explícito. El ejemplo siguiente presupone que los valores utilizados se pueden representar como int tras convertirlos a unsigned char. Establece LC_CTYPE en "C" e imprime el resultado tras normalizarlo a bool, de modo que la salida esperada no dependa del valor distinto de cero concreto que devuelva la biblioteca.

Ejemplos

#include <cctype>
#include <clocale>
#include <initializer_list>
#include <iostream>

int main() {
    if (std::setlocale(LC_CTYPE, "C") == nullptr) {
        return 1;
    }

    for (char ch : {'A', 'z', '7', '_'}) {
        const bool letter =
            std::isalpha(static_cast<unsigned char>(ch)) != 0;
        std::cout << ch << ": " << letter << '\n';
    }
}

Resultado

A: 1
z: 1
7: 0
_: 0

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