Verifica se um float é NAN

# is_nan

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

is_nan — Verifica se um float é NAN

### Descrição

function 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

- is_finite() - Verifica se um float é finito
- is_infinite() - Verifica se um float é infinito

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open