std::isnan

来自cppreference.com
< cpp‎ | numeric‎ | math
 
 
 
常用数学函数
函数
基本运算
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)(C++11)(C++11)
指数函数
(C++11)
(C++11)
(C++11)
(C++11)
幂函数
(C++11)
(C++11)
三角与双曲函数
(C++11)
(C++11)
(C++11)
误差与伽马函数
(C++11)
(C++11)
(C++11)
(C++11)
临近整数的浮点运算
(C++11)(C++11)(C++11)
(C++11)
(C++11)
(C++11)(C++11)(C++11)
浮点操作函数
(C++11)(C++11)
(C++11)
(C++11)
(C++11)(C++11)
(C++11)
分类/比较
(C++11)
(C++11)
(C++11)
isnan
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
宏常量
(C++11)(C++11)(C++11)(C++11)(C++11)
 
在标头 <cmath> 定义
(1)
bool isnan( float num );

bool isnan( double num );

bool isnan( long double num );
(C++11 起)
(C++23 前)
constexpr bool isnan( /* 浮点类型 */ num );
(C++23 起)
在标头 <cmath> 定义
template< class Integer >
bool isnan( Integer num );
(A) (C++11 起)
(C++23 起 constexpr)
1) 确定给定的浮点数 num 是否为非数(NaN)值。标准库提供所有以无 cv 限定的浮点类型作为参数 num 的类型的重载。 (C++23 起)
A) 为所有整数类型提供额外重载,将它们当做 double

参数

num - 浮点或整数值

返回值

num 为 NaN 时返回 true,否则返回 false

注解

有多个拥有不同符号位和载荷的不同 NaN 值,参阅 std::nanstd::numeric_limits::quiet_NaN

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

另一种测试浮点值是否 NaN 的方式是与自身比较:bool is_nan(double x) { return x != x; }

GCCClang 支持 -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)
检查给定数是否正规
(函数)
检查两个浮点值是否无顺序
(函数)