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

    To Top