is_nan

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

is_nan — Verifica se um float é NAN

Descrição

is_nan(float $num): bool

Retorna indicando se o num é um NAN (Not A Number).

NAN é retornado de operações matemáticas que são indefinidas, por exemplo ao passar parâmetros fora do domínio de entrada da função. A raiz quadrada (sqrt()) só é definida para números positivos, e informar um número negativo resultará em NAN. Outros exemplos de operações que retornam NAN são a divisão de INF por INF e operações que envolvam um valor NAN existente.

Note:

Apesar do nome Not A Number, NAN é um valor válido do tipo float.

Caution

NAN não se compara em igualdade a NAN. Para verificar se um float é NAN, is_nan() deve ser utilizado. Usar $float === NAN não funcionará.

Parâmetros

num

O float a ser verificado

Valor Retornado

true se num for NAN, senão retorna false.

Exemplos

Example #1 Exemplo de is_nan()

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

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

O exemplo acima produzirá:

float(NAN)
bool(true)

Veja Também