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.