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.