std::isfinite
来自 cppreference.cn
定义于头文件 <cmath> |
||
(1) | ||
bool isfinite( float num ); bool isfinite( double num ); |
(自 C++11) (直至 C++23) |
|
constexpr bool isfinite( /*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 isfinite( Integer num ); |
(A) | (自 C++11) (constexpr 自 C++23 起) |
1) 确定给定的浮点数 num 是否具有有限值,即它是正规的、次正规的或零,但不是无限或 NaN。 库为所有 cv 无限定的浮点类型作为参数 num 的类型提供了重载。(自 C++23 起)
S) SIMD 重载对 v_num 执行逐元素
std::isfinite 。
|
(自 C++26) |
A) 为所有整数类型提供了额外的重载,它们被视为 double。
目录 |
[编辑] 参数
num | - | 浮点或整数值 |
v_num | - | 一种数据并行对象,为 std::basic_simd 特化的,其元素类型为浮点类型 |
[编辑] 返回值
1) 如果 num 具有有限值,则为 true,否则为 false。
S) 一种数据并行掩码对象,其中第 i 个元素等于 true,如果 v_num[i] 具有有限值,否则对于范围
[
0,
v_num.size())
中的所有 i,则为 false。[编辑] 注解
额外的重载不需要完全按照 (A) 提供。它们只需要足以确保对于整数类型的参数 num,std::isfinite(num) 具有与 std::isfinite(static_cast<double>(num)) 相同的效果。
[编辑] 示例
运行此代码
#include <cfloat> #include <cmath> #include <iostream> int main() { std::cout << std::boolalpha << "isfinite(NaN) = " << std::isfinite(NAN) << '\n' << "isfinite(Inf) = " << std::isfinite(INFINITY) << '\n' << "isfinite(-Inf) = " << std::isfinite(-INFINITY) << '\n' << "isfinite(HUGE_VAL) = " << std::isfinite(HUGE_VAL) << '\n' << "isfinite(0.0) = " << std::isfinite(0.0) << '\n' << "isfinite(exp(800)) = " << std::isfinite(std::exp(800)) << '\n' << "isfinite(DBL_MIN/2.0) = " << std::isfinite(DBL_MIN / 2.0) << '\n'; }
输出
isfinite(NaN) = false isfinite(Inf) = false isfinite(-Inf) = false isfinite(HUGE_VAL) = false isfinite(0.0) = true isfinite(exp(800)) = false isfinite(DBL_MIN/2.0) = true
[编辑] 参见
(C++11) |
对给定的浮点值进行分类 (函数) |
(C++11) |
检查给定的数字是否为无穷大 (函数) |
(C++11) |
检查给定的数字是否为 NaN (函数) |
(C++11) |
检查给定的数字是否为正规的 (函数) |
C 文档 关于 isfinite
|