std::numeric_limits<T>::signaling_NaN

来自cppreference.com
 
 
 
 
 
static T signaling_NaN()throw();
(C++11 前)
staticconstexpr T signaling_NaN()noexcept;
(C++11 起)

返回特殊值“发信的非数”,以浮点类型 T 表示。只有在 std::numeric_limits<T>::has_signaling_NaN==true 时才有意义。在最常见的浮点数二进制表示 IEEE 754 中,任何所有指数位都是 1 且至少有一位尾数位是 1 的值都表示 NaN。哪些尾数值表示安静或发信的 NaN,及符号位是否有意义都由实现定义。

目录

[编辑]返回值

Tstd::numeric_limits<T>::signaling_NaN()
/* 未特化 */T()
boolfalse
char0
signedchar0
unsignedchar0
wchar_t0
char8_t(C++20 起)0
char16_t(C++11 起)0
char32_t(C++11 起)0
short0
unsignedshort0
int0
unsignedint0
long0
unsignedlong0
longlong(C++11 起)0
unsignedlonglong(C++11 起)0
float 由实现定义(可以是 FLT_SNAN
double 由实现定义(可以是 DBL_SNAN
longdouble 由实现定义(可以是 LDBL_SNAN

[编辑]注解

NaN 与自身永远不会比较相等。IEEE-754 不要求复制 NaN 保留它的位表示(正负号与载荷),尽管大多数实现都会保留。

当发信 NaN 被用于算术表达式的实参时,可能引发适当的浮点异常,而且 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\n";elseif(n ==0)std::cout<<"没有引发异常\n";   std::feclearexcept(FE_ALL_EXCEPT);}   int main(){double snan =std::numeric_limits<double>::signaling_NaN();std::cout<<"在获取 sNaN 后,"; show_fe_exceptions();   double qnan = snan *2.0;std::cout<<"在将 sNaN 乘以 2 后,"; show_fe_exceptions();   double qnan2 = qnan *2.0;std::cout<<"在将安静 NaN 乘以 2 后,"; show_fe_exceptions();   std::cout<<"结果是 "<< qnan2 <<'\n';}

输出:

在获取 sNaN 后,没有引发异常 在将 sNaN 乘以 2 后,引发了 FE_INVALID 在将安静 NaN 乘以 2 后,没有引发异常 结果是 nan

[编辑]参阅

鉴别能表示特殊值“发信的非数”(NaN)的浮点数类型
(公开静态成员常量)[编辑]
[静态]
返回给定浮点数类型的安静 NaN 值
(公开静态成员函数)[编辑]
(C++11)
检查给定的数是否 NaN
(函数)[编辑]
close