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

CKTIS / C++

std::isdigit — verificar dígitos

std::isdigit de <cctype> verifica se um carácter é um dígito decimal. Devolve int, não bool. Após a conversão de um carácter para unsigned char, o valor obtido tem de ser representável como int.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

#include <cctype>
// Signature: int std::isdigit(int c)

std::isdigit de <cctype> reconhece os dígitos '0'–'9'. Devolve zero para os outros caracteres e um valor diferente de zero para os dígitos — não necessariamente 1. Teste o resultado com != 0, não com == 1.

O valor passado ao parâmetro do tipo int tem de ser representável como unsigned char ou ser igual a EOF; caso contrário, o comportamento é indefinido. Para uma variável char c, a chamada std::isdigit(static_cast<unsigned char>(c)) é segura para qualquer valor de c se UCHAR_MAX <= INT_MAX (ambas as macros estão disponíveis em <climits>). Se UCHAR_MAX > INT_MAX, guarde o resultado de static_cast<unsigned char>(c) em u e chame std::isdigit(static_cast<int>(u)) apenas se u <= INT_MAX. Caso contrário, não passe u a esta função: a conversão para int pode produzir um valor negativo diferente de EOF. Verifique se o resultado do tipo int de uma função de entrada é EOF antes de o converter.

Esta função classifica um único carácter; não analisa um número nem descodifica UTF-8. A sobrecarga distinta std::isdigit(c, loc) de <locale> utiliza uma faceta de locale; não a confunda com a função de um argumento descrita aqui.

Exemplos

#include <cctype>
#include <climits>
#include <initializer_list>
#include <iostream>

int main() {
    for (char c : {'7', 'A', '0'}) {
        const auto u = static_cast<unsigned char>(c);
        const bool digit = u <= INT_MAX
            ? std::isdigit(static_cast<int>(u)) != 0
            : (c >= '0' && c <= '9');
        std::cout << c << ": " << digit << '\n';
    }
}

Resultado

7: 1
A: 0
0: 1

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