| Common mathematical functions | |||||||||||||||||||||||||||||||
| Mathematical special functions(C++17) | |||||||||||||||||||||||||||||||
| Mathematical constants(C++20) | |||||||||||||||||||||||||||||||
| Basic linear algebra algorithms(C++26) | |||||||||||||||||||||||||||||||
| Data-parallel types (SIMD)(C++26) | |||||||||||||||||||||||||||||||
| Floating-point environment(C++11) | |||||||||||||||||||||||||||||||
| Complex numbers | |||||||||||||||||||||||||||||||
Numeric array (valarray) | |||||||||||||||||||||||||||||||
| Pseudo-random number generation | |||||||||||||||||||||||||||||||
| Bit manipulation(C++20) | |||||||||||||||||||||||||||||||
| Saturation arithmetic(C++26) | |||||||||||||||||||||||||||||||
| Factor operations | |||||||||||||||||||||||||||||||
|
| ||||||||||||||||||||||||||||||
| Interpolations | |||||||||||||||||||||||||||||||
|
| ||||||||||||||||||||||||||||||
| Generic numeric operations | |||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||
| C-style checked integer arithmetic | |||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||
| Nearest integer floating point operations | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Floating point manipulation functions | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Classification and comparison | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Types | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Macro constants | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Defined in header <cmath> | ||
| (1) | ||
bool isnan(float num); bool isnan(double num); | (since C++11) (until C++23) | |
constexprbool isnan(/*floating-point-type*/ num); | (since C++23) | |
SIMD overload(since C++26) | ||
Defined in header <simd> | ||
template</*math-floating-point*/ V> constexprtypename/*deduced-simd-t*/<V>::mask_type | (S) | (since C++26) |
Defined in header <cmath> | ||
template<class Integer> bool isnan( Integer num); | (A) | (since C++11) (constexpr since C++23) |
S) The SIMD overload performs an element-wise std::isnan onv_num.
| (since C++26) |
Contents |
| num | - | floating-point or integer value |
| v_num | - | a data-parallel object ofstd::basic_simd specialization where its element type is a floating-point type |
[0, v_num.size()).There are many different NaN values with different sign bits and payloads, seestd::nan andstd::numeric_limits::quiet_NaN.
NaN values never compare equal to themselves or to other NaN values. Copying a NaN is not required, by IEEE-754, to preserve its bit representation (sign andpayload), though most implementation do.
Another way to test if a floating-point value is NaN is to compare it with itself:bool is_nan(double x){return x!= x;}.
GCC andClang support a-ffinite-math option (additionally implied by-ffast-math), which allows the respective compiler to assume the nonexistence of special IEEE-754 floating point values such as NaN, infinity, or negative zero. In other words,std::isnan is assumed to always returnfalse under this option.
The additional overloads are not required to be provided exactly as(A). They only need to be sufficient to ensure that for their argumentnum of integer type,std::isnan(num) has the same effect asstd::isnan(static_cast<double>(num)).
#include <cfloat>#include <cmath>#include <iostream> int main(){std::cout<<std::boolalpha<<"isnan(NaN) = "<< std::isnan(NAN)<<'\n'<<"isnan(Inf) = "<< std::isnan(INFINITY)<<'\n'<<"isnan(0.0) = "<< std::isnan(0.0)<<'\n'<<"isnan(DBL_MIN/2.0) = "<< std::isnan(DBL_MIN/2.0)<<'\n'<<"isnan(0.0 / 0.0) = "<< std::isnan(0.0/0.0)<<'\n'<<"isnan(Inf - Inf) = "<< std::isnan(INFINITY-INFINITY)<<'\n';}
Output:
isnan(NaN) = trueisnan(Inf) = falseisnan(0.0) = falseisnan(DBL_MIN/2.0) = falseisnan(0.0 / 0.0) = trueisnan(Inf - Inf) = true
(C++11)(C++11)(C++11) | not-a-number (NaN) (function)[edit] |
(C++11) | categorizes the given floating-point value (function)[edit] |
(C++11) | checks if the given number has finite value (function)[edit] |
(C++11) | checks if the given number is infinite (function)[edit] |
(C++11) | checks if the given number is normal (function)[edit] |
(C++11) | checks if two floating-point values are unordered (function)[edit] |
C documentation forisnan | |
