ctype_digit

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

ctype_digitChequear posibles caracteres numéricos

Descripción

ctype_digit ( string $text ) : bool

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

Parámetros

text

La cadena probada.

Valores devueltos

Devuelve TRUE si cada caracter del texto es un dígito decimal, o FALSE de lo contrario.

Historial de cambios

Versión Descripción
5.1.0 En versiones anteriores a PHP 5.1.0, esta función devolvía TRUE cuando text era una cadena vacía.

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
?>

Notas

Nota:

Esta función espera un string para ser útil, por ejemplo si pasamos un integer no puede devolver el resultado esperado. Sin embargo, nótese también los formularios HTML resultarán en strings numéricos y no en integers. Ver también la sección del manual tipos.

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.

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