Проверяет, представляет ли собой число с плавающей точкой нечисло

# is_nan

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

is_nan — Проверяет, представляет ли собой число с плавающей точкой нечисло

### Описание

function is_nan(float `$num`): bool

Возвращает результат проверки того, представляет ли собой переданное в параметр `num` значение — нечисло `NAN` (Not A Number).

Нечисло (`NAN`) — неопределённый результат математического вычисления, бывает, например, тогда, когда передаваемые параметры выходят за пределы области входных данных функции. Квадратный корень числа (функция sqrt()) может быть определён только для положительных чисел, передача (в функцию) отрицательного числа приведёт к состоянию нечисла (`NAN`). Другие примеры операций, возвращающих нечисло (`NAN`), — деление положительного бесконечного числа (`INF`) на другое бесконечное положительное число (`INF`) или любая операция, аргументами которой будет нечисло (`NAN`).

> Замечание:

> Несмотря на сказанное выше, нечисло (`NAN`) — это допустимое значение для типа float.

Предостережение

Нечисло (`NAN`) не тождественно другому нечислу (`NAN`). Соответствие числа с плавающей точкой нечислу (`NAN`) проверяют функцией is_nan(). Проверка `$float === NAN` не сработает.

### Список параметров

`num`

  Проверяемое число с плавающей точкой (float).

### Возвращаемые значения

Функция возвращает `true`, если значение параметра `num` — нечисло (`NAN`), иначе `false`.

### Примеры

Пример #1 Пример использования функции is_nan()

    <?php

    $nan = sqrt(-1);

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

    ?>

Результат выполнения приведённого примера:

    float(NAN)
    bool(true)

### Смотрите также

- is_finite() - Проверяет, конечно ли число с плавающей точкой
- is_infinite() - Проверяет, бесконечно ли число с плавающей точкой

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