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

is_finite() - Verifica se um float é finito
is_infinite() - Verifica se um float é infinito

Melhore Esta Página

Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema

＋adicione uma nota

Notas Enviadas por Usuários (em inglês) 4 notes

down

darkangel at moveinmod dot net ¶

18 years ago

nan/"not a number" is not meant to see if the data type is numeric/textual/etc..

NaN is actually a set of values which can be stored in floating-point variables, but dont actually evaluate to a proper floating point number.

The floating point system has three sections: 1 bit for the sign (+/-), an 8 bit exponent, and a 23 bit fractional part.
There are rules governing which combinations of values can be placed into each section, and some values are reserved for numbers such as infinity. This leads to certain combinations being invalid, or in other words, not a number.

down

10basetom ¶

9 years ago

I would use is_numeric() instead of ctype_digit() if you cannot be 100% sure what data type the string will be. Example from the docs:

<?php
$numeric_string = '42';
$integer        = 42;

ctype_digit($numeric_string);  // true
ctype_digit($integer);         // false (ASCII 42 is the * character)

is_numeric($numeric_string);   // true
is_numeric($integer);          // true
?>

down

ScorpioT1000 ¶

4 years ago

function is_nan2($n) {
    return $n !== $n;
}

is_nan2(NAN); // true

down

php at darkain dot com ¶

8 years ago

Starting with PHP 7, the string 'NaN' evaluates to the NaN value as well. 

Example:
var_dump( (float) 'NaN' );

PHP 5.x and HHVM:
float(0)

PHP 7.0:
float(NAN)

＋adicione uma nota