is_nan

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

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

Описание

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() - Проверяет, бесконечно ли число с плавающей точкой

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

＋Добавить

Примечания пользователей 4 notes

down

darkangel at moveinmod dot net ¶

18 years ago

nan/"not a number" is not meant to see if the data type is numeric/textual/etc..

NaN is actually a set of values which can be stored in floating-point variables, but dont actually evaluate to a proper floating point number.

The floating point system has three sections: 1 bit for the sign (+/-), an 8 bit exponent, and a 23 bit fractional part.
There are rules governing which combinations of values can be placed into each section, and some values are reserved for numbers such as infinity. This leads to certain combinations being invalid, or in other words, not a number.

down

10basetom ¶

9 years ago

I would use is_numeric() instead of ctype_digit() if you cannot be 100% sure what data type the string will be. Example from the docs:

<?php
$numeric_string = '42';
$integer        = 42;

ctype_digit($numeric_string);  // true
ctype_digit($integer);         // false (ASCII 42 is the * character)

is_numeric($numeric_string);   // true
is_numeric($integer);          // true
?>

down

ScorpioT1000 ¶

4 years ago

function is_nan2($n) {
    return $n !== $n;
}

is_nan2(NAN); // true

down

php at darkain dot com ¶

8 years ago

Starting with PHP 7, the string 'NaN' evaluates to the NaN value as well. 

Example:
var_dump( (float) 'NaN' );

PHP 5.x and HHVM:
float(0)

PHP 7.0:
float(NAN)

＋Добавить