std:: isdigit
Defined in header
<cctype>
|
||
int
isdigit
(
int
ch
)
;
|
||
Checks if the given character is one of the 10 decimal digits: (
0123456789
).
The behavior is undefined if the value of ch is not representable as unsigned char and is not equal to EOF .
Parameters
ch | - | character to classify |
Return value
Non-zero value if the character is a numeric character, zero otherwise.
Notes
isdigit
and
isxdigit
are the only standard narrow character classification functions that are not affected by the currently installed C locale. although some implementations (e.g. Microsoft in
1252 codepage
) may classify additional single-byte characters as digits.
Like all other functions from
<cctype>
, the behavior of
std::isdigit
is undefined if the argument's value is neither representable as
unsigned
char
nor equal to
EOF
. To use these functions safely with plain
char
s (or
signed
char
s), the argument should first be converted to
unsigned
char
:
bool my_isdigit(char ch) { return std::isdigit(static_cast<unsigned char>(ch)); }
Similarly, they should not be directly used with standard algorithms when the iterator's value type is char or signed char . Instead, convert the value to unsigned char first:
int count_digits(const std::string& s) { return std::count_if(s.begin(), s.end(), // static_cast<int(*)(int)>(std::isdigit) // wrong // [](int c){ return std::isdigit(c); } // wrong // [](char c){ return std::isdigit(c); } // wrong [](unsigned char c){ return std::isdigit(c); } // correct ); }
Example
Output:
0123456789
See also
checks if a character is classified as a digit by a locale
(function template) |
|
checks if a wide character is a digit
(function) |
|
C documentation
for
isdigit
|
ASCII values | characters |
isdigit
|
|||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
decimal | hexadecimal | octal | |||||||||||||
0–8 |
\x0
–
\x8
|
\0
–
\10
|
control codes (
NUL
, etc.)
|
≠0
|
0
|
0
|
0
|
0
|
0
|
0
|
0
|
0
|
0
|
0
|
0
|
9 |
\x9
|
\11
|
tab (
\t
)
|
≠0
|
0
|
≠0
|
≠0
|
0
|
0
|
0
|
0
|
0
|
0
|
0
|
0
|
10–13 |
\xA
–
\xD
|
\12
–
\15
|
whitespaces (
\n
,
\v
,
\f
,
\r
)
|
≠0
|
0
|
≠0
|
0
|
0
|
0
|
0
|
0
|
0
|
0
|
0
|
0
|
14–31 |
\xE
–
\x1F
|
\16
–
\37
|
control codes |
≠0
|
0
|
0
|
0
|
0
|
0
|
0
|
0
|
0
|
0
|
0
|
0
|
32 |
\x20
|
\40
|
space |
0
|
≠0
|
≠0
|
≠0
|
0
|
0
|
0
|
0
|
0
|
0
|
0
|
0
|
33–47 |
\x21
–
\x2F
|
\41
–
\57
|
!"#$%&'()*+,-./
|
0
|
≠0
|
0
|
0
|
≠0
|
≠0
|
0
|
0
|
0
|
0
|
0
|
0
|
48–57 |
\x30
–
\x39
|
\60
–
\71
|
0123456789
|
0
|
≠0
|
0
|
0
|
≠0
|
0
|
≠0
|
0
|
0
|
0
|
≠0
|
≠0
|
58–64 |
\x3A
–
\x40
|
\72
–
\100
|
:;<=>?@
|
0
|
≠0
|
0
|
0
|
≠0
|
≠0
|
0
|
0
|
0
|
0
|
0
|
0
|
65–70 |
\x41
–
\x46
|
\101
–
\106
|
ABCDEF
|
0
|
≠0
|
0
|
0
|
≠0
|
0
|
≠0
|
≠0
|
≠0
|
0
|
0
|
≠0
|
71–90 |
\x47
–
\x5A
|
\107
–
\132
|
GHIJKLMNOP
QRSTUVWXYZ
|
0
|
≠0
|
0
|
0
|
≠0
|
0
|
≠0
|
≠0
|
≠0
|
0
|
0
|
0
|
91–96 |
\x5B
–
\x60
|
\133
–
\140
|
[\]^_`
|
0
|
≠0
|
0
|
0
|
≠0
|
≠0
|
0
|
0
|
0
|
0
|
0
|
0
|
97–102 |
\x61
–
\x66
|
\141
–
\146
|
abcdef
|
0
|
≠0
|
0
|
0
|
≠0
|
0
|
≠0
|
≠0
|
0
|
≠0
|
0
|
≠0
|
103–122 |
\x67
–
\x7A
|
\147
–
\172
|
ghijklmnop
qrstuvwxyz
|
0
|
≠0
|
0
|
0
|
≠0
|
0
|
≠0
|
≠0
|
0
|
≠0
|
0
|
0
|
123–126 |
\x7B
–
\x7E
|
\172
–
\176
|
{|}~
|
0
|
≠0
|
0
|
0
|
≠0
|
≠0
|
0
|
0
|
0
|
0
|
0
|
0
|
127 |
\x7F
|
\177
|
backspace character (
DEL
)
|
≠0
|
0
|
0
|
0
|
0
|
0
|
0
|
0
|
0
|
0
|
0
|
0
|