std::isfinite
来自cppreference.com
<tbody>
</tbody>
<tbody class="t-dcl-rev t-dcl-rev-num ">
</tbody><tbody>
</tbody>
| 在标头 <cmath> 定义
|
||
| (1) | ||
bool isfinite( float num ); bool isfinite( double num ); bool isfinite( long 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 isfinite ( const V& v_num ); |
(S) | (C++26 起) |
| 在标头 <cmath> 定义
|
||
template< class Integer > bool isfinite( Integer num ); |
(A) | (C++11 起) (C++23 起为 constexpr) |
1) 确定给定的浮点数
num 是否拥有有限值，即它是正规、非正规或零，但不是无穷大或 NaN。标准库提供所有以无 cv 限定的浮点数类型作为形参 num 的类型的重载。(C++23 起)|
S) SIMD 重载对
v_num 实施逐元素 isfinite}。S) SIMD 重载对
v_num 实施逐元素 std::isfinite。
|
(C++26 起) |
A) 为所有整数类型提供额外重载，将它们当做
double。参数
| num | - | 浮点数或整数 |
| v_num | - | std::basic_simd 的特化类型的数据并行对象，其元素类型是浮点数类型 |
返回值
1) 在
num 拥有有限值时返回 true，否则返回 false。S) 返回一个数据并行掩模对象，对于范围
[0, v_num.size()) 中的所有 i，其第 i 个元素在 v_num[i] 拥有有限值 时等于 true 否则等于 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) |
检查给定数是否正规 (函数) |
isfinite 的 C 文档
| |