ctype_xdigit

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

ctype_xdigit — Chequear posibles caracteres que representen un dígito hexadecimal

Descripción

ctype_xdigit(mixed $text): bool

Verifica si todos los caracteres de la string entregada, text, son 'dígitos' hexadecimales.

Parámetros

text

La cadena de prueba.

Nota:
Si se proporciona un integer entre -128 y 255 inclusive, se interpreta como el valor ASCII de un simple caráter (a los valores negativos se le añade 256 para permitir caracteres en el rango ASCII Extendido). Cualquier otro entero se interpreta como una cadena que contiene los dígitos decimales del entero.

Advertencia

As of PHP 8.1.0, passing a non-string argument is deprecated. In the future, the argument will be interpreted as a string instead of an ASCII codepoint. Depending on the intended behavior, the argument should either be cast to string or an explicit call to chr() should be made.

Valores devueltos

Devuelve true si cada caracter del text es un 'dígito' hexadecimal, lo que quiere decir un dígito decimal o un caracter del rango [A-Fa-f]; false de lo contrario. When called with an empty string the result will always be false.

Ejemplos

Ejemplo #1 Un ejemplo de ctype_xdigit()

<?php
$cadenas = array('AB10BC99', 'AR1012', 'ab12bc99');
foreach ($cadenas as $caso_prueba) {
    if (ctype_xdigit($caso_prueba)) {
        echo "La cadena $caso_prueba consiste completamente de dígitos hexadecimales.\n";
    } else {
        echo "La cadena $caso_prueba no consiste completamente de dígitos hexadecimales.\n";
    }
}
?>

El resultado del ejemplo sería:

La cadena AB10BC99 consiste completamente de dígitos hexadecimales.
La cadena AR1012 no consiste completamente de dígitos hexadecimales.
La cadena ab12bc99 consiste completamente de dígitos hexadecimales.

Ver también

ctype_digit() - Chequear posibles caracteres numéricos
IntlChar::isxdigit() - Comprobar si el punto de código es un dígito hexadecimal

Improve This Page

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 2 notes

down

tom at hgmail dot com ¶

18 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

-3

Anonymous ¶

1 year 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