KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::isdigit — cijfers controleren

std::isdigit uit <cctype> controleert of een teken een decimaal cijfer is. De functie geeft int terug, geen bool. Na omzetting van een teken naar unsigned char moet de waarde in int passen.

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

Syntax

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

std::isdigit uit <cctype> herkent de cijfers '0'–'9'. Voor andere tekens geeft de functie nul terug en voor cijfers een waarde die niet nul is — niet noodzakelijk 1. Controleer het resultaat met != 0, niet met == 1.

De waarde die je aan de parameter van het type int doorgeeft, moet als unsigned char kunnen worden weergegeven of gelijk zijn aan EOF; anders is het gedrag ongedefinieerd. Voor een variabele char c is std::isdigit(static_cast<unsigned char>(c)) veilig voor elke waarde van c als UCHAR_MAX <= INT_MAX (beide macro’s zijn beschikbaar in <climits>). Als UCHAR_MAX > INT_MAX, sla dan het resultaat van static_cast<unsigned char>(c) op als u en roep std::isdigit(static_cast<int>(u)) alleen aan als u <= INT_MAX. Geef u anders niet door aan deze functie: de omzetting naar int kan een negatieve waarde opleveren die niet gelijk is aan EOF. Controleer of het int-resultaat van een invoerfunctie gelijk is aan EOF voordat je het omzet.

Deze functie classificeert één teken; ze parseert geen getal en decodeert geen UTF-8. De afzonderlijke overload std::isdigit(c, loc) uit <locale> gebruikt een locale-facet; verwar die niet met de hier beschreven functie met één argument.

Voorbeelden

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

Resultaat

7: 1
A: 0
0: 1

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen