命名空间
变体
操作

std::isnan

来自 cppreference.cn
< cpp‎ | 数值‎ | 数学
 
 
 
常用数学函数
函数
基本操作
(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)(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( /*floating-point-type*/ num );
(C++23 起)
SIMD 重载 (C++26 起)
定义于头文件 <simd>
template< /*数学浮点类型*/ V >

constexpr typename /*推导的 simd 类型*/<V>::mask_type

  isnan ( const V& v_num );
(S) (C++26 起)
定义于头文件 <cmath>
template< class Integer >
bool isnan( Integer num );
(A) (C++11 起)
(C++23 起为 constexpr)
1) 确定给定的浮点数 num 是否为非数字 (NaN) 值。 库为所有 cv-不限定的浮点类型作为参数 num 的类型提供了重载。(C++23 起)
S) SIMD 重载在 v_num 上执行逐元素 std::isnan
(有关它们的定义,请参阅 math-floating-pointdeduced-simd-t。)
(C++26 起)
A) 为所有整数类型提供了额外的重载,它们被视为 double

目录

[编辑] 参数

num - 浮点值或整数值
v_num - 一个 std::basic_simd 特化的数据并行对象,其元素类型为浮点类型

[编辑] 返回值

1) 如果 num 是 NaN,则为 true,否则为 false
S) 一个数据并行掩码对象,其中对于范围 [0v_num.size()) 内的所有 i,其第 i 个元素如果 v_num[i] 是 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) 完全相同。它们只需足以确保对于整数类型的参数 numstd::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 文档,关于 isnan