Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::isdigit — verificare le cifre

std::isdigit di <cctype> verifica se un carattere è una cifra decimale. Restituisce int, non bool. Dopo la conversione di un carattere in unsigned char, il valore ottenuto deve essere rappresentabile come int.

Versione: C++23; repository compiler flag, production runtime not attested

Sintassi

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

std::isdigit di <cctype> riconosce le cifre '0'–'9'. Restituisce zero per gli altri caratteri e un valore diverso da zero per le cifre, non necessariamente 1. Verifica il risultato con != 0, non con == 1.

Il valore passato al parametro di tipo int deve essere rappresentabile come unsigned char oppure essere uguale a EOF; in caso contrario, il comportamento è indefinito. Per una variabile char c, la chiamata std::isdigit(static_cast<unsigned char>(c)) è sicura per qualsiasi valore di c se UCHAR_MAX <= INT_MAX (entrambe le macro sono disponibili in <climits>). Se UCHAR_MAX > INT_MAX, salva il risultato di static_cast<unsigned char>(c) in u e chiama std::isdigit(static_cast<int>(u)) solo se u <= INT_MAX. In caso contrario, non passare u a questa funzione: la conversione in int può produrre un valore negativo diverso da EOF. Prima di convertire il risultato di tipo int di una funzione di input, verifica che non sia EOF.

Questa funzione classifica un singolo carattere; non analizza un numero e non decodifica UTF-8. L’overload distinto std::isdigit(c, loc) di <locale> usa una facet locale; non confonderlo con la funzione a un argomento descritta qui.

Esempi

#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';
    }
}

Risultato

7: 1
A: 0
0: 1

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti