CKTIS / C++
std::isdigit — Ziffern prüfen
std::isdigit aus <cctype> prüft, ob ein Zeichen eine Dezimalziffer ist. Die Funktion gibt int und nicht bool zurück. Nach der Umwandlung eines Zeichens in unsigned char muss der Wert als int darstellbar sein.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <cctype>
// Signature: int std::isdigit(int c)std::isdigit aus <cctype> erkennt die Ziffern '0'–'9'. Für andere Zeichen gibt die Funktion null zurück, für Ziffern einen Wert ungleich null — nicht unbedingt 1. Prüfe das Ergebnis mit != 0, nicht mit == 1.
Der an den Parameter vom Typ int übergebene Wert muss als unsigned char darstellbar oder gleich EOF sein; andernfalls ist das Verhalten undefiniert. Für eine Variable char c ist std::isdigit(static_cast<unsigned char>(c)) für jeden Wert von c sicher, wenn UCHAR_MAX <= INT_MAX gilt (beide Makros stehen in <climits> zur Verfügung). Gilt UCHAR_MAX > INT_MAX, speichere das Ergebnis von static_cast<unsigned char>(c) als u und rufe std::isdigit(static_cast<int>(u)) nur auf, wenn u <= INT_MAX gilt. Andernfalls darfst du u nicht an diese Funktion übergeben: Bei der Umwandlung in int kann ein negativer Wert entstehen, der nicht EOF ist. Prüfe das Ergebnis einer Eingabefunktion vom Typ int auf EOF, bevor du es umwandelst.
Damit wird ein einzelnes Zeichen klassifiziert; die Funktion parst weder eine Zahl noch dekodiert sie UTF-8. Die separate Überladung std::isdigit(c, loc) aus <locale> verwendet eine Locale-Facette. Verwechsle sie nicht mit der hier beschriebenen Funktion mit einem Argument.
Beispiele
#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';
}
}
Ergebnis
7: 1 A: 0 0: 1
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.