std::isnan
来自cppreference.com
| 在标头 <cmath> 定义
|
||
| (1) | ||
bool isnan( float num ); bool isnan( double num ); |
(C++11 起) (C++23 前) |
|
| constexpr bool isnan( /*floating-point-type*/ num ); |
(C++23 起) | |
| SIMD 重载 (C++26 起) |
||
| 在标头 <simd> 定义
|
||
| template< /*math-floating-point*/ V > constexpr typename /*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 文档
| |
