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 ZahlNAN (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 numNAN 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

    To Top