std::numeric_limits<T>::signaling_NaN

static T signaling_NaN() throw();

static constexpr T signaling_NaN() noexcept;

Возвращает специальное значение «сигнализирующая не число», представленное типом с плавающей точкой T. Имеет смысл только если std::numeric_limits<T>::has_signaling_NaN == true. В IEEE 754, самом распространенном двоичном представлении чисел с плавающей точкой, любое значение, у которого все биты экспоненты установлены, а по крайней мере один бит мантиссы установлен, представляет собой NaN. Реализация определяет, какие значения мантиссы представляют собой тихие или сигнализирующие NaN, и значим ли бит знака.

Значение возврата

Примечания

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

При использовании сигнализирующего NaN в качестве аргумента арифметического выражения может быть поднято соответствующее исключение с плавающей точкой, и NaN будет «усмирен», то есть выражение возвратит тихий NaN.

Пример

#include <cfenv>
#include <iostream>
#include <limits>
 
#pragma STDC_FENV_ACCESS on
 
void show_fe_exceptions()
{
    int n = std::fetestexcept(FE_ALL_EXCEPT);
 
    if (n & FE_INVALID)
        std::cout << "FE_INVALID is raised\n";
    else if (n == 0)
        std::cout << "no exceptions are raised\n";
 
    std::feclearexcept(FE_ALL_EXCEPT);
}
 
int main()
{
    double snan = std::numeric_limits<double>::signaling_NaN();
    std::cout << "After sNaN was obtained, ";
    show_fe_exceptions();
 
    double qnan = snan * 2.0;
    std::cout << "After sNaN was multiplied by 2, ";
    show_fe_exceptions();
 
    double qnan2 = qnan * 2.0;
    std::cout << "After the quieted NaN was multiplied by 2, ";
    show_fe_exceptions();
 
    std::cout << "The result is " << qnan2 << '\n';
}

After sNaN was obtained, no exceptions are raised
After sNaN was multiplied by 2, FE_INVALID is raised
After the quieted NaN was multiplied by 2, no exceptions are raised
The result is nan

См. также