Submit a Pull Request Report a Bug

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() - Проверяет наличие цифровых символов в строке

＋add a note

User Contributed Notes 2 notes

down

tom at hgmail dot com ¶

17 years ago


This function shows its usefulness on a web site where a user is asked to entered a hexidecimal color code for a color. To prevent breaking W3C standard and having them enter in "neon-green" or the wrong type of code like 355511235.

In conjunction with strlen()  you could create a function like this:

function check_valid_colorhex($colorCode) {
    // If user accidentally passed along the # sign, strip it off
    $colorCode = ltrim($colorCode, '#');

    if (
          ctype_xdigit($colorCode) &&
          (strlen($colorCode) == 6 || strlen($colorCode) == 3))
               return true;

    else return false;
}

down

Anonymous ¶

3 months ago


this can be used with great results if you wanna check for something like 

"Tobias2" whether there is a number at the end of the string. (F.e. courselist with coursenames etc.)

Just substring the last char and put it in the function. 
We should be glad about every possibility to cut out these damn regexes from our code. NEVER USE REGEX

＋add a note