std::isfinite

Определён в заголовочном файле `<cmath>`
bool isfinite( float num ); bool isfinite( double num ); bool isfinite( long double num );	(1)	(начиная с C++11) (до C++23)
constexpr bool isfinite( /floating-point-type/ num );	(1)		(начиная с 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) (constexpr начиная с C++23)

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

S) Перегрузка SIMD выполняет поэлементную операцию std::isfinite над 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()).

Примечания

Не требуется, чтобы дополнительные перегрузки были предоставлены именно в виде (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

См. также

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

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