SysTutorials

Linux Manual Pages › Section 3

stdisfinite(3)

std::isfinite – std::isfinite

Synopsis

Defined in header <cmath>
bool isfinite( float arg ); (1) (since C++11)
bool isfinite( double arg ); (2) (since C++11)
bool isfinite( long double arg ); (3) (since C++11)
bool isfinite( IntegralType arg ); (4) (since C++11)
1-3) Determines if the given floating point number arg has finite value i.e. it is normal, subnormal or zero, but not infinite or NaN.
4) A set of overloads or a function template accepting the arg argument of any integral_type. Equivalent to (2) (the argument is cast to double).

Parameters

arg – floating point value

Return value

true if arg has finite value, false otherwise

Examples

// Run this code

#include <iostream>
#include <cmath>
#include <cfloat>
int main()
{
    std::cout << std::boolalpha
              << "isfinite(NaN) = " << std::isfinite(NAN) << '
'
              << "isfinite(Inf) = " << std::isfinite(INFINITY) << '
'
              << "isfinite(0.0) = " << std::isfinite(0.0) << '
'
              << "isfinite(exp(800)) = " << std::isfinite(std::exp(800)) << '
'
              << "isfinite(DBL_MIN/2.0) = " << std::isfinite(DBL_MIN / 2.0) << '
';
}

Output:

  isfinite(NaN) = false
  isfinite(Inf) = false
  isfinite(0.0) = true
  isfinite(exp(800)) = false
  isfinite(DBL_MIN/2.0) = true

See also

fpclassify categorizes the given floating point value
           (function)
(C++11)
isinf checks if the given number is infinite
           (function)
(C++11)
isnan checks if the given number is NaN
           (function)
(C++11)
isnormal checks if the given number is normal
           (function)
(C++11)