ctype_digit
(PHP 4 >= 4.0.4, PHP 5)
ctype_digit — Chequear posibles caracteres numéricos
Descripción
$text
)
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