array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.is-nan.php', 1 => 'is_nan', 2 => 'Verifica se um float é NAN', ), 'up' => array ( 0 => 'ref.math.php', 1 => 'Funções de Math', ), 'prev' => array ( 0 => 'function.is-infinite.php', 1 => 'is_infinite', ), 'next' => array ( 0 => 'function.log.php', 1 => 'log', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/math/functions/is-nan.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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.

Nota:

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

Cuidado

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

Exemplo #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