Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::isdigit — kontrola číslic

std::isdigit z <cctype> kontroluje, zda je znak desítkovou číslicí. Vrací int, nikoli bool. Po převodu znaku na unsigned char musí být získaná hodnota reprezentovatelná typem int.

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

Syntaxe

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

std::isdigit z <cctype> rozpoznává číslice '0'–'9'. Pro ostatní znaky vrací nulu a pro číslice nenulovou hodnotu — ne nutně 1. Výsledek testujte pomocí != 0, nikoli == 1.

Hodnota předaná parametru typu int musí být reprezentovatelná typem unsigned char nebo se rovnat EOF; jinak je chování nedefinované. Pro proměnnou char c je volání std::isdigit(static_cast<unsigned char>(c)) bezpečné pro každou hodnotu c, pokud platí UCHAR_MAX <= INT_MAX (obě makra jsou dostupná v <climits>). Pokud platí UCHAR_MAX > INT_MAX, uložte výsledek static_cast<unsigned char>(c) do u a volejte std::isdigit(static_cast<int>(u)) pouze tehdy, když u <= INT_MAX. Jinak hodnotu u této funkci nepředávejte: převod na int může dát zápornou hodnotu odlišnou od EOF. Před převodem výsledku typu int ze vstupní funkce ověřte, zda se rovná EOF.

Tato funkce klasifikuje jeden znak; neparsuje číslo ani nedekóduje UTF-8. Samostatné přetížení std::isdigit(c, loc) z <locale> používá lokalizační facet; nezaměňujte je se zde popsanou funkcí s jedním argumentem.

Příklady

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

Výsledek

7: 1
A: 0
0: 1

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje