Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes