std::isinf

来自cppreference.com
< cpp‎ | numeric‎ | math
 
 
 
常用数学函数
函数
基础运算
(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)
(C++11)
isinf
(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 isinf( float num );

bool isinf( double num );

bool isinf( long double num );
(C++11 起)
(C++23 前)
constexpr bool isinf( /*floating-point-type*/ num );
(C++23 起)
SIMD 重载 (C++26 起)
在标头 <simd> 定义
template< /*math-floating-point*/ V >

constexpr typename /*deduced-simd-t*/<V>::mask_type

  isinf ( const V& v_num );
(S) (C++26 起)
在标头 <cmath> 定义
template< class Integer >
bool isinf( Integer num );
(A) (C++11 起)
(C++23 起为 constexpr)
1) 确定给定浮点数 num 是否为正或负无穷大。标准库提供所有以无 cv 限定的浮点数类型作为形参 num 的类型的重载。(C++23 起)
S) SIMD 重载对 v_num 实施逐元素 isinf}。
S) SIMD 重载对 v_num 实施逐元素 std::isinf
(参见 math-floating-pointdeduced-simd-t 的定义。)
(C++26 起)
A) 为所有整数类型提供额外重载,将它们当做 double

目录

[编辑] 参数

num - 浮点数或整数
v_num - std::basic_simd 的特化类型的数据并行对象,其元素类型是浮点数类型

[编辑] 返回值

1)num 为无穷大时返回 true,否则返回 false
S) 返回一个数据并行掩模对象,对于范围 [0v_num.size()) 中的所有 i,其第 i 个元素在 v_num[i] 为无穷大 时等于 true 否则等于 false

[编辑] 注解

GCCClang 支持 -ffinite-math 选项(并额外由 -ffast-math 蕴含),此选项允许编译器假设 IEEE-754 特殊浮点数(例如 NaN,无限和负零)不存在。也就是说,在此选项下会假设 std::isinf 固定返回 false

额外重载不需要以 (A) 的形式提供。它们只需要能够对它们的整数类型实参 num 确保 std::isinf(num)std::isinf(static_cast<double>(num)) 的效果相同。

[编辑] 示例

#include <cfloat>
#include <cmath>
#include <iostream>
#include <limits>
 
int main()
{
    const double max = std::numeric_limits<double>::max();
    const double inf = std::numeric_limits<double>::infinity();
 
    std::cout << std::boolalpha
              << "isinf(NaN) = " << std::isinf(NAN) << '\n'
              << "isinf(Inf) = " << std::isinf(INFINITY) << '\n'
              << "isinf(max) = " << std::isinf(max) << '\n'
              << "isinf(inf) = " << std::isinf(inf) << '\n'
              << "isinf(0.0) = " << std::isinf(0.0) << '\n'
              << "isinf(exp(800)) = " << std::isinf(std::exp(800)) << '\n'
              << "isinf(DBL_MIN/2.0) = " << std::isinf(DBL_MIN / 2.0) << '\n';
}

输出:

isinf(NaN) = false
isinf(Inf) = true
isinf(max) = false
isinf(inf) = true
isinf(0.0) = false
isinf(exp(800)) = true
isinf(DBL_MIN/2.0) = false

[编辑] 参阅

归类给定的浮点数
(函数) [编辑]
(C++11)
检查给定数是否拥有有限值
(函数) [编辑]
(C++11)
检查给定的数是否 NaN
(函数) [编辑]
(C++11)
检查给定数是否正规
(函数) [编辑]
isinf 的 C 文档