std::isnan

bool isnan( float num );
bool isnan( double num );
bool isnan( long double num );

constexpr bool isnan( /* floating-point-type */ num );

template< class Integer >
bool isnan( Integer num );

Параметры

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

true , если num является NaN, false в противном случае.

Примечания

Существует множество различных значений 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

См. также