std::isinf

Определено в заголовочном файле `<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 );	(1)		(начиная с 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) (constexpr начиная с C++23)

1) Определяет, является ли заданное число с плавающей точкой num положительной или отрицательной бесконечностью. Библиотека предоставляет перегрузки для всех типов с плавающей точкой без квалификаторов cv в качестве типа параметра num.(начиная с C++23)

S) Перегрузка SIMD выполняет поэлементную операцию std::isinf над v_num. (См. math-floating-point и deduced-simd-t, где приведены их определения.) (начиная с C++26)

A) Для всех целочисленных типов предоставляются дополнительные перегрузки, в которых они рассматриваются как double.

Параметры

num	-	значение с плавающей точкой или целочисленное значение
v_num	-	объект с параллельной обработкой данных — специализация `std::basic_simd`, элементами которой являются значения с плавающей точкой

Возвращаемое значение

1) true, если num — бесконечность, и false в противном случае.

S) Объект-маска с параллельной обработкой данных, i-й элемент которого равен true, если v_num[i] — бесконечность, и false в противном случае для всех i в диапазоне [0, v_num.size()).

Примечания

GCC и Clang поддерживают параметр -ffinite-math (который также подразумевается параметром -ffast-math). Он позволяет соответствующему компилятору предполагать отсутствие специальных значений с плавающей точкой IEEE-754, таких как NaN, бесконечность или отрицательный ноль. Иными словами, при использовании этого параметра предполагается, что std::isinf всегда возвращает false.

Необязательно, чтобы дополнительные перегрузки предоставлялись точно в виде (A). Достаточно, чтобы они обеспечивали для аргумента num целочисленного типа тот же эффект, что и std::isinf(static_cast<double>(num)) у std::isinf(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

См. также

fpclassify (C++11)	классифицирует заданное значение с плавающей точкой (функция)
isfinite (C++11)	проверяет, является ли заданное число конечным (функция)
isnan (C++11)	проверяет, является ли заданное число значением NaN (функция)
isnormal (C++11)	проверяет, является ли заданное число нормальным (функция)
Документация по C для `isinf`

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/numeric/math/isinf