ctype_digit

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

ctype_digitCheck for numeric character(s)

Опис

ctype_digit(mixed $text): bool

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

Параметри

text

The tested string.

Зауваження:

Ціле число (int) від -128 до 255 включно вважається кодом символу ASCII (від'ємні значення збільшуються на 256, що дає доступ до розширеного діапазону ASCII). Інші цілі числа вважаються рядками, що містять ціле десяткове число у вигляді цифр.

Увага

Починаючи з PHP 8.1.0, параметр, що не є рядком — застарів. У майбутньому параметр вважатиметься виключно рядком, а не кодом символу з ASCII. Залежно від наміченої поведінки, параметр буде або приведено до string, або явно опрацьовано функцією chr().

Значення, що повертаються

Returns true if every character in the string text is a decimal digit, false otherwise. Якщо викликано з порожнім рядком — результатом буде false.

Приклади

Приклад #1 A ctype_digit() example

<?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 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.

Приклад #2 A ctype_digit() example comparing strings with integers

<?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
?>

Прогляньте також

  • ctype_alnum() - Check for alphanumeric character(s)
  • ctype_xdigit() - Check for character(s) representing a hexadecimal digit
  • is_numeric() - Finds whether a variable is a number or a numeric string
  • is_int() - Find whether the type of a variable is integer
  • is_string() - Перевіряє, чи має задана змінна рядковий тип даних
  • IntlChar::isdigit() - Check if code point is a digit character