ctype_digit

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

ctype_digitChequear posibles caracteres numéricos

Descripción

ctype_digit(mixed$text): bool

Verifica si todos los caracteres en la string entregada, text, son numéricos.

Parámetros

text

La cadena probada.

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 texto es un dígito decimal, o false de lo contrario. When called with an empty string the result will always be false.

Ejemplos

Ejemplo #1 Un ejemplo de ctype_digit()

<?php
$cadenas
= array('1820.20', '10002', 'wsl!12');
foreach (
$cadenas as $caso_prueba) {
if (
ctype_digit($caso_prueba)) {
echo
"La cadena $caso_prueba consiste completamente de dígitos.\n";
} else {
echo
"La cadena $caso_prueba no consiste completamente de dígitos.\n";
}
}
?>

El resultado del ejemplo sería:

La cadena 1820.20 no consiste completamente de dígitos. La cadena 10002 consiste completamente de dígitos. La cadena wsl!12 no consiste completamente de dígitos.

Ejemplo #2 Un ejemplo de ctype_digit() comparando strings con integers

<?php

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

ctype_digit($numeric_string); // true
ctype_digit($integer); // false (ASCII 42 es el caracter *)

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

Ver también

  • ctype_alnum() - Chequear posibles caracteres alfanuméricos
  • ctype_xdigit() - Chequear posibles caracteres que representen un dígito hexadecimal
  • is_numeric() - Comprueba si una variable es un número o un string numérico
  • is_int() - Comprueba si el tipo de una variable es integer
  • is_string() - Comprueba si una variable es de tipo string
  • IntlChar::isdigit() - Comprobar si un punto de código es un carácter de dígito
To Top