std::isfinite(3)

πŸ“¦ version 2024.07.05, in nixpkgs unstable, opensuse-leap 16.0

✨ std::isfinite(3) ✨

okay bestie, this is the std::isfinite page from the C++ Standard Libary πŸ’… it's the little math gremlin that answers "is this number finite?" and honestly? we love a straightforward icon 🧚


🌸 NAME 🌸

std::isfinite - std::isfinite (yes bestie, the name is the name, and it's serving repetition chic πŸ’€)


πŸ¦‹ Synopsis πŸ¦‹

Defined in header <cmath>:

  • bool isfinite( float num ); β€” (since C++11)
  • bool isfinite( double num ); β€” (until C++23)
  • bool isfinite( long double num );
  • constexpr bool isfinite( /* floating-point-type */ num ); β€” (1) (since C++23)

✨ Additional overloads ✨

Defined in header <cmath>:

template< class Integer >
bool isfinite( Integer num );
  • (A) β€” (since C++11)
  • (constexpr since C++23)

So like, 1) Determines if the given floating point number num has finite value i.e. it is normal, subnormal or zero, but not infinite or NaN.

The library provides overloads for all cv-unqualified floating-point types as the type of the parameter num. (since C++23)

A) Additional overloads are provided for all integer types, which are treated as double.


πŸŽ€ Parameters πŸŽ€

  • num β€” floating-point or integer value

πŸ’– Return value πŸ’–

true if num has finite value, false otherwise. that's the vibe check, bestie βœ…


✨ Notes ✨

The additional overloads are not required to be provided exactly as (A). They only need to be sufficient to ensure that for their argument num of integer type, std::isfinite(num) has the same effect as std::isfinite(static_cast<double>(num)).

fr fr, that's the whole note 🫢


🌈 Examples 🌈

// Run this code

        #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';
        }

Output:

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

πŸ‘‘ See also πŸ‘‘

  • fpclassify β€” categorizes the given floating-point value (C++11) (function)
  • isinf β€” checks if the given number is infinite (C++11) (function)
  • isnan β€” checks if the given number is NaN (C++11) (function)
  • isnormal β€” checks if the given number is normal (C++11) (function)
  • C documentation for isfinite

okay that's the page, bestie 🫢 it came from http://cppreference.com, dated 2024.06.10, and it's std::isfinite(3) β€” mwah πŸ’‹

πŸ“¦ where this page comes from