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() - Проверяет, относится ли кодовая точка к шестнадцатеричной цифре
To Top