Namespaces
Variants

std:: isnan

From cppreference.net
C++
Numerics library
Common mathematical functions
Nearest integer floating point operations
(C++11)
(C++11)
(C++11) (C++11) (C++11)
Floating point manipulation functions
(C++11) (C++11)
(C++11)
(C++11)
Classification and comparison
(C++11)
(C++11)
(C++11)
isnan
(C++11)
(C++11)
(C++11)
Types
(C++11)
(C++11)
(C++11)
Macro constants
Определено в заголовке <cmath>
(1)
bool isnan ( float num ) ;

bool isnan ( double num ) ;

bool isnan ( long double num ) ;
(начиная с C++11)
(до C++23)
constexpr bool isnan ( /*floating-point-type*/ num ) ;
(начиная с C++23)
SIMD перегрузка (начиная с C++26)
Определено в заголовке <simd>
template < /*math-floating-point*/ V >

constexpr typename /*deduced-simd-t*/ < V > :: mask_type

isnan ( const V & v_num ) ;
(S) (начиная с C++26)
Определено в заголовке <cmath>
template < class Integer >
bool isnan ( Integer num ) ;
(A) (начиная с C++11)
(constexpr начиная с C++23)
1) Определяет, является ли заданное число с плавающей запятой num значением не-числа (NaN). Библиотека предоставляет перегрузки для всех cv-неквалифицированных типов с плавающей запятой в качестве типа параметра num . (начиная с C++23)
S) Перегрузка SIMD выполняет поэлементную операцию std::isnan на v_num .
(См. math-floating-point и deduced-simd-t для их определений.)
(since C++26)
A) Для всех целочисленных типов предоставлены дополнительные перегрузки, которые обрабатываются как double .

Содержание

Параметры

num - значение с плавающей точкой или целочисленное значение
v_num - объект с параллельной обработкой данных специализации std::basic_simd , тип элементов которого является типом с плавающей точкой

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

1) true если num является NaN, false в противном случае.
S) Объект маски с параллельной обработкой данных, в котором i й элемент равен true если v_num [ i ] является NaN или false в противном случае для всех i в диапазоне [ ​ 0 ​ , v_num. size ( ) ) .

Примечания

Существует множество различных значений NaN с различными знаковыми битами и полезными нагрузками, см. std::nan и std::numeric_limits::quiet_NaN .

Значения NaN никогда не сравниваются равными с самими собой или с другими значениями NaN. Копирование NaN не требует, согласно IEEE-754, сохранения его битового представления (знак и полезная нагрузка ), хотя большинство реализаций это делают.

Еще один способ проверить, является ли значение с плавающей точкой NaN - сравнить его с самим собой: bool is_nan ( double x ) { return x ! = x ; } .

GCC и Clang поддерживают опцию -ffinite-math (также неявно включаемую с помощью -ffast-math ), которая позволяет соответствующему компилятору предполагать отсутствие специальных значений с плавающей точкой IEEE-754, таких как NaN, бесконечность или отрицательный ноль. Другими словами, std::isnan предполагается всегда возвращающей false при использовании этой опции.

Дополнительные перегрузки не обязаны быть предоставлены в точности как (A) . Они лишь должны быть достаточными для обеспечения того, чтобы для их аргумента num целочисленного типа, std :: isnan ( num ) имел тот же эффект, что и std :: isnan ( static_cast < double > ( num ) ) .

Пример

Запустить этот код 
#include <cfloat>
#include <cmath>
#include <iostream>
int main()
{
    std::cout << std::boolalpha
              << "isnan(NaN) = " << std::isnan(NAN) << '\n'
              << "isnan(Inf) = " << std::isnan(INFINITY) << '\n'
              << "isnan(0.0) = " << std::isnan(0.0) << '\n'
              << "isnan(DBL_MIN/2.0) = " << std::isnan(DBL_MIN / 2.0) << '\n'
              << "isnan(0.0 / 0.0)   = " << std::isnan(0.0 / 0.0) << '\n'
              << "isnan(Inf - Inf)   = " << std::isnan(INFINITY - INFINITY) << '\n';
}

Вывод: 

isnan(NaN) = true
isnan(Inf) = false
isnan(0.0) = false
isnan(DBL_MIN/2.0) = false
isnan(0.0 / 0.0)   = true
isnan(Inf - Inf)   = true

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

(C++11) (C++11) (C++11)
не-число (NaN)
(функция)
(C++11)
классифицирует заданное значение с плавающей точкой
(функция)
(C++11)
проверяет, имеет ли заданное число конечное значение
(функция)
(C++11)
проверяет, является ли заданное число бесконечным
(функция)
(C++11)
проверяет, является ли заданное число нормальным
(функция)
(C++11)
проверяет, являются ли два значения с плавающей точкой неупорядоченными
(функция)
Документация C для isnan