php8.5
Home/ Manual/ ctype / functions/ ctype_digit

ctype_digit

PHP function Edit on GitHub ✎

(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)

Check for numeric character(s)

Description

ctype_digit(mixed $text): bool

Checks if all of the characters in the provided string, text, are numerical.

Parameters

text

The tested string. Integer Non-string

Return Values

Returns true if every character in the string text is a decimal digit, false otherwise. Empty-string

Examples

A ctype_digit() example

php
<?php
$strings = array('1820.20', '10002', 'wsl!12');
foreach ($strings as $testcase) {
    if (ctype_digit($testcase)) {
        echo "The string $testcase consists of all digits.\n";
    } else {
        echo "The string $testcase does not consist of all digits.\n";
    }
}
?>

The above example will output:

output
The string 1820.20 does not consist of all digits.
The string 10002 consists of all digits.
The string wsl!12 does not consist of all digits.

A ctype_digit() example comparing strings with integers

php
<?php

$numeric_string = '42';
$integer        = 42;

ctype_digit($numeric_string);  // true
ctype_digit($integer);         // false (ASCII 42 is the * character)

is_numeric($numeric_string);   // true
is_numeric($integer);          // true
?>

See Also

Source: reference/ctype/functions/ctype-digit.xml · from the official PHP manual (php/doc-en)