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

    To Top