std::isnan
来自cppreference.com
在标头 <cmath> 定义 | ||
| (1) | ||
bool isnan(float num ); bool isnan(double num ); | (C++11 起) (C++23 前) | |
constexprbool isnan(/*floating-point-type*/ num ); | (C++23 起) | |
SIMD 重载(C++26 起) | ||
在标头 <simd> 定义 | ||
template</*math-floating-point*/ V > constexprtypename/*deduced-simd-t*/<V>::mask_type | (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 实施逐元素 isnan}。S) SIMD 重载对 v_num 实施逐元素 std::isnan。
| (C++26 起) |
A) 为所有整数类型提供额外重载，将它们当做 double。
目录 |
[编辑]参数
| num | - | 浮点数或整数 |
| v_num | - | std::basic_simd 的特化类型的数据并行对象，其元素类型是浮点数类型 |
[编辑]返回值
1) 在 num 为 NaN 时返回 true，否则返回 false。
S) 返回一个数据并行掩模对象，对于范围
[0, v_num.size()) 中的所有 i，其第 i 个元素在 v_num[i] 为 NaN 时等于 true 否则等于 false。[编辑]注解
有多个拥有不同符号位和载荷的不同 NaN 值，参阅 std::nan 及 std::numeric_limits::quiet_NaN。
NaN 值永远不会与自身或其他 NaN 值比较相等。IEEE-754 不要求复制 NaN 保留它的位表示（符号与载荷），尽管大多数实现会保留。
另一种测试浮点数是否 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
[编辑]参阅
(C++11)(C++11)(C++11) | 非数（NaN） (函数) |
(C++11) | 归类给定的浮点数 (函数) |
(C++11) | 检查给定数是否拥有有限值 (函数) |
(C++11) | 检查给定数是否为无限 (函数) |
(C++11) | 检查给定数是否正规 (函数) |
(C++11) | 检查两个浮点数是否无顺序 (函数) |
isnan 的 C 文档 | |
