std::isfinite

来自cppreference.com
< cpp‎ | numeric‎ | math
 
C++
 
数值库
 
常用数学函数
函数
基础运算
(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)
isfinite
(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)


 
在标头 <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。
（参见 math-floating-point 和 deduced-simd-t 的定义。）
(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 文档
来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/numeric/math/isfinite&oldid=87250”