is_nan

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

is_nan — Prüft, ob eine Gleitkommazahl NAN ist

Beschreibung

is_nan(float $num): bool

Gibt zurück, ob die angegebene Zahl NAN (Not A Number) ist.

NAN wird von mathematischen Operationen zurückgegeben, die undefiniert sind, z. B. bei der Übergabe von Parametern außerhalb des Eingabebereichs einer Funktion. Die Quadratwurzel (sqrt()) ist nur für positive Zahlen definiert, die Übergabe einer negativen Zahl führt zu NAN. Andere Beispiele für Operationen, die NAN zurückgeben, sind die Division von INF durch INF und jede Operation, die sich auf einen bestehenden NAN-Wert bezieht.

Hinweis:
Trotz seines Namens Not A Number ist NAN (keine Zahl) ein gültiger Wert vom Typ Float.

Achtung

NAN kann nicht mit NAN verglichen werden. Um zu prüfen, ob ein float NAN ist, muss is_nan() verwendet werden. Zu prüfen, ob $float === NAN ist, funktioniert nicht.

Parameter-Liste

num: Die zu überprüfende Gleitkommazahl

Rückgabewerte

Gibt true zurück, wenn num NAN ist, andernfalls false.

Beispiele

Beispiel #1 is_nan()-Beispiel

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

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

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

float(NAN)
bool(true)

Siehe auch

is_finite() - Prüft, ob eine Gleitkommazahl endlich ist
is_infinite() - Prüft, ob eine Gleitkommazahl unendlich ist

Improve This Page

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