CKTIS / C++
std::isalpha — verificar se um carácter é uma letra
std::isalpha de <cctype> verifica se um valor representa uma letra de acordo com a localidade C atual. Devolve int: zero ou um valor diferente de zero. Para classificar um valor do tipo char, converta-o para unsigned char e só passe o resultado se for representável como int.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#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> classifica um único valor de carácter segundo a categoria LC_CTYPE da localidade C atual. Devolve int: um valor diferente de zero para uma letra e 0 nos restantes casos. Teste != 0, não == 1 — um resultado verdadeiro não tem necessariamente de ser igual a 1.
O valor passado ao parâmetro do tipo int tem de ser igual a EOF ou ser representável como unsigned char; os outros valores causam comportamento indefinido. Para uma variável char ch, a conversão apenas para int não corrige um valor negativo de char. Avalie primeiro static_cast<unsigned char>(ch). A chamada std::isalpha(static_cast<unsigned char>(ch)) é segura para qualquer ch se UCHAR_MAX <= INT_MAX. Se UCHAR_MAX > INT_MAX, verifique se o valor obtido não excede INT_MAX antes de o converter para int (ambos os limites estão definidos em <climits>). Um valor superior a INT_MAX não pode ser passado sem alteração: a conversão pode resultar em EOF ou noutro valor negativo que cause comportamento indefinido. Não chame a função para um byte deste tipo. Mantenha como int o resultado de uma função de entrada que devolva int e verifique se é EOF antes de converter o byte.
Na localidade "C", as letras são A–Z e a–z; outras localidades podem reconhecer letras adicionais. A função não descodifica UTF-8: classificar bytes individuais não determina se um carácter Unicode multibyte é uma letra.
Não confunda esta função com std::isalpha(ch, loc), de dois argumentos e pertencente a <locale>, que devolve bool e utiliza um objeto de localidade explícito. O exemplo abaixo pressupõe que os valores utilizados são representáveis como int depois de convertidos para unsigned char. Define LC_CTYPE como "C" e apresenta o resultado depois de o normalizar para bool, pelo que o resultado esperado não depende do valor específico diferente de zero devolvido pela biblioteca.
Exemplos
#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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.