is_nan

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

is_nan — Vérifie si un nombre flottant est NAN

Description

is_nan(float $num): bool

Retourne si le num donné est NAN (Not A Number).

NAN est retourné par les opérations mathématiques qui ne sont pas définies, par exemple lors du passage de paramètres en dehors du domaine d'entrée de la fonction. La racine carrée (sqrt()) n'est définie que pour les nombres positifs, le passage d'un nombre négatif résultera en un NAN. D'autres exemples d'opérations renvoyant NAN sont la division de INF par INF et toute opération impliquant une valeur NAN existante.

Note:
Malgré son nom Not A Number, NAN est une valeur valide de type nombre décimal.

Attention

NAN ne se compare pas égal à NAN. Pour vérifier si un nombre flottant est NAN, is_nan() doit être utilisé. La vérification de $float === NAN ne fonctionnera pas.

Liste de paramètres

num: Le nombre décimal à vérifier

Valeurs de retour

true si num est NAN, sinon false.

Exemples

Exemple #1 Exemple avec is_nan()

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

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

L'exemple ci-dessus va afficher :

float(NAN)
bool(true)

Voir aussi

is_finite() - Vérifie si un nombre flottant est fini
is_infinite() - Vérifie si un nombre flottant est infini

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 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)

＋add a note