◐ Shell
clean mode source ↗

std::isinf - cppreference.com

来自cppreference.com

在标头 <cmath> 定义 

bool isinf( float num );
bool isinf( double num );
bool isinf( long double num );
(1) (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 起)

A) 为所有整数类型提供额外重载，将它们当做 double。

参数

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

返回值

1) 在 num 为无穷大时返回 true，否则返回 false。

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

注解

GCC 和 Clang 支持 -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

参阅