is_numeric

(PHP 4, PHP 5, PHP 7)

is_numeric Comprueba si una variable es un número o un string numérico

Descripción

is_numeric ( mixed $var ) : bool

Comprueba si la variable dada es numérica. Los string numéricos consisten en un signo opcional, cualquier número de dígitos, una parte decimal opcional y una parte exponencial opcional. En consecuencia, +0123.45e6 es un valor numérico válido. Las notaciones hexadecimal (p.ej. 0xf4c3b00c), binary (p.ej. 0b10100111001), octal (p.ej. 0777) están permitidas pero únicamente sin signo, parte decimal y exponencial.

Parámetros

var

La variable a evaluar.

Valores devueltos

Devuelve TRUE si var es un número o una cadena numérica, FALSE de lo contrario.

Ejemplos

Ejemplo #1 Ejemplos de is_numeric()

<?php
$pruebas 
= array(
    
"42",
    
1337,
    
0x539,
    
02471,
    
0b10100111001,
    
1337e0,
    
"no numérico",
    array(),
    
9.1
);

foreach(
$pruebas as $element) {
    if(
is_numeric($element)) {
        echo 
"'{$element}' es numérico"PHP_EOL;
    } else {
        echo 
"'{$element}' NO es numérico"PHP_EOL;
    }
}
?>

El resultado del ejemplo sería:

'42' es numérico
'1337' es numérico
'1337' es numérico
'1337' es numérico
'1337' es numérico
'1337' es numérico
'no numérico' NO es numérico
'Array' NO es numérico
'9.1' es numérico

Historial de cambios

Versión Descripción
7.0.0 Las cadenas en notación hexadecimal (p.ej. 0xf4c3b00c) ya no son consideradas como cadenas numéricas, esto es, is_numeric() ahora devuelve FALSE.

Ver también

  • ctype_digit() - Chequear posibles caracteres numéricos
  • is_bool() - Comprueba si una variable es de tipo booleano
  • is_null() - Comprueba si una variable es NULL
  • is_float() - Comprueba si el tipo de una variable es float
  • is_int() - Comprueba si el tipo de una variable es integer
  • is_string() - Comprueba si una variable es de tipo string
  • is_object() - Comprueba si una variable es un objeto
  • is_array() - Comprueba si una variable es un array