is_nan

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

is_nanVerifica si un número flotante es NAN

Descripción

is_nan(float $num): bool

Devuelve si el num dado es NAN (Not A Number).

NAN es devuelto por las operaciones matemáticas que no están definidas, por ejemplo al pasar argumentos fuera del dominio de entrada de la función. La raíz cuadrada (sqrt()) solo está definida para números positivos, el paso de un número negativo resultará en un NAN. Otros ejemplos de operaciones que devuelven NAN son la división de INF por INF y cualquier operación que involucre un valor NAN existente.

Nota:

A pesar de su nombre Not A Number, NAN es un valor válido de tipo nombre décimal.

Precaución

NAN no se compara igual a NAN. Para verificar si un número flotante es NAN, is_nan() debe ser utilizado. La verificación de $float === NAN no funcionará.

Parámetros

num

El nombre décimal a verificar

Valores devueltos

true si num es NAN, de lo contrario false.

Ejemplos

Ejemplo #1 Ejemplo con is_nan()

<?php
$nan
= sqrt(-1);

var_dump($nan, is_nan($nan));
?>

El resultado del ejemplo sería:

float(NAN)
bool(true)

Ver también

  • is_finite() - Verifica si un número flotante es finito
  • is_infinite() - Verifica si un número de tipo float es infinito