ctype_digit

(PHP 4 >= 4.0.4, PHP 5)

ctype_digit — Проверяет на наличие цифровых символов в строке

Описание

bool ctype_digit ( string $text )

Проверяет, являются ли все символы в строке text цифровыми.

Список параметров

text: Проверяемая строка.

Возвращаемые значения

Возвращает TRUE если каждый символ строки text является десятичной цифрой, либо FALSE в противном случае.

Список изменений

Версия	Описание
5.1.0	До версии PHP 5.1.0 эта функция возвращала `TRUE`, если в качестве `text` передавалась пустая строка.

Примеры

Пример #1 Пример использования ctype_digit()


<?php
$strings = array('1820.20', '10002', 'wsl!12');
foreach ($strings as $testcase) {
    if (ctype_digit($testcase)) {
        echo "Строка $testcase состоит только из цифр.\n";
    } else {
        echo "Строка $testcase не состоит только из цифр.\n";
    }
}
?>

Результат выполнения данного примера:

Строка 1820.20 не состоит только из цифр.
Строка 10002 состоит только из цифр.
Строка wsl!12 не состоит только из цифр.

Пример #2 Пример использования ctype_digit() со сравнением строк и целых чисел


<?php

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

ctype_digit($numeric_string);  // true
ctype_digit($integer);         // false (ASCII 42 это символ * )

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

Примечания

Замечание:
Для извлечения пользы из работы этой функции ей необходимо передавать строку (string), поэтому, если ей, к примеру, будет передан integer, то она может не возвратить ожидаемый результат. Однако, необходимо учитывать, что HTML-формы передают числовые строки, а не целые числа. Подробнее читайте в разделе "Типы" данного руководства.

Смотрите также

ctype_alnum() - Проверяет на наличие буквенно-цифровых символов
ctype_xdigit() - Проверяет наличие шестнадцатиричных цифр
is_numeric() - Проверяет, является ли переменная числом или строкой, содержащей число
is_int() - Проверяет, является ли переменная переменной целочисленного типа
is_string() - Проверяет, является ли переменная строкой