ctype_xdigit

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

ctype_xdigitПроверяет наличие шестнадцатеричных цифр

Описание

ctype_xdigit(mixed $text): bool

Проверяет, являются ли все символы в строке (string) text шестнадцатеричными 'цифрами'.

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

text

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

Замечание:

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

Внимание

Начиная с PHP 8.1.0, передача нестроковых аргументов устарела. В будущем аргумент будет интерпретироваться как строка вместо кода ASCII. В зависимости от предполагаемого поведения аргумент должен быть приведён к строке (string) или должен быть сделан явный вызов функции chr().

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

Возвращает true, если каждый символ строки text является шестнадцатеричной 'цифрой', то есть десятичной цифрой или символом из диапазона [A-Fa-f], и false в противном случае. При вызове с пустой строкой результатом всегда будет false.

Примеры

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

<?php
$strings
= array('AB10BC99', 'AR1012', 'ab12bc99');
foreach (
$strings as $testcase) {
if (
ctype_xdigit($testcase)) {
echo
"Строка $testcase состоит из шестнадцатеричных цифр.\n";
} else {
echo
"Строка $testcase состоит не только из шестнадцатеричных цифр.\n";
}
}
?>

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

Строка AB10BC99 состоит из шестнадцатеричных цифр.
Строка AR1012 состоит не только из шестнадцатеричных цифр.
Строка ab12bc99 состоит из шестнадцатеричных цифр.

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

  • ctype_digit() - Проверяет наличие цифровых символов в строке
  • IntlChar::isxdigit() - Проверить, является ли символ шестнадцатеричной цифрой