Namespaces
Variants

std:: isnan

From cppreference.net
C++
Numerics library
Common mathematical functions
Nearest integer floating point operations
(C++11)
(C++11)
(C++11) (C++11) (C++11)
Floating point manipulation functions
(C++11) (C++11)
(C++11)
(C++11)
Classification and comparison
(C++11)
(C++11)
(C++11)
isnan
(C++11)
(C++11)
(C++11)
Types
(C++11)
(C++11)
(C++11)
Macro constants
Definiert in Header <cmath>
(1)
bool isnan ( float num ) ;

bool isnan ( double num ) ;

bool isnan ( long double num ) ;
(seit C++11)
(bis C++23)
constexpr bool isnan ( /*floating-point-type*/ num ) ;
(seit C++23)
SIMD-Überladung (seit C++26)
Definiert in Header <simd>
template < /*math-floating-point*/ V >

constexpr typename /*deduced-simd-t*/ < V > :: mask_type

isnan ( const V & v_num ) ;
(S) (seit C++26)
Definiert in Header <cmath>
template < class Integer >
bool isnan ( Integer num ) ;
(A) (seit C++11)
(constexpr seit C++23)
1) Bestimmt, ob die gegebene Gleitkommazahl num ein Not-a-Number (NaN)-Wert ist. Die Bibliothek bietet Überladungen für alle cv-unqualifizierten Gleitkommatypen als Typ des Parameters num an. (seit C++23)
S) Die SIMD-Überladung führt eine elementweise std::isnan auf v_num aus.
(Siehe math-floating-point und deduced-simd-t für deren Definitionen.)
(seit C++26)
A) Zusätzliche Überladungen werden für alle Ganzzahltypen bereitgestellt, die als double behandelt werden.

Inhaltsverzeichnis

Parameter

num - Gleitkomma- oder Ganzzahlwert
v_num - ein datenparalleles Objekt von std::basic_simd Spezialisierung, dessen Elementtyp ein Gleitkommatyp ist

Rückgabewert

1) true falls num ein NaN ist, false andernfalls.
S) Ein datenparalleles Maskenobjekt, bei dem das i te Element gleich true ist, wenn v_num [ i ] ein NaN ist, oder false andernfalls, für alle i im Bereich [ ​ 0 ​ , v_num. size ( ) ) .

Hinweise

Es gibt viele verschiedene NaN-Werte mit unterschiedlichen Vorzeichenbits und Nutzdaten, siehe std::nan und std::numeric_limits::quiet_NaN .

NaN-Werte sind niemals gleich sich selbst oder anderen NaN-Werten. Das Kopieren eines NaN-Werts muss laut IEEE-754 nicht seine Bitdarstellung (Vorzeichen und Payload ) erhalten, obwohl die meisten Implementierungen dies tun.

Eine weitere Möglichkeit, um zu testen, ob ein Gleitkommawert NaN ist, besteht darin, ihn mit sich selbst zu vergleichen: bool is_nan ( double x ) { return x ! = x ; } .

GCC und Clang unterstützen eine -ffinite-math Option (zusätzlich impliziert durch -ffast-math ), die es dem jeweiligen Compiler erlaubt, die Nichtexistenz spezieller IEEE-754 Gleitkommawerte wie NaN, Unendlich oder negative Null anzunehmen. Mit anderen Worten wird angenommen, dass std::isnan unter dieser Option immer false zurückgibt.

Die zusätzlichen Überladungen müssen nicht exakt wie (A) bereitgestellt werden. Sie müssen lediglich sicherstellen, dass für ihr Argument num vom Ganzzahltyp std :: isnan ( num ) dieselbe Wirkung hat wie std :: isnan ( static_cast < double > ( num ) ) .

Beispiel

Diesen Code ausführen 
#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';
}

Ausgabe: 

isnan(NaN) = true
isnan(Inf) = false
isnan(0.0) = false
isnan(DBL_MIN/2.0) = false
isnan(0.0 / 0.0)   = true
isnan(Inf - Inf)   = true

Siehe auch

(C++11) (C++11) (C++11)
Keine Zahl (NaN)
(Funktion)
(C++11)
kategorisiert den gegebenen Gleitkommawert
(Funktion)
(C++11)
prüft, ob die gegebene Zahl einen endlichen Wert hat
(Funktion)
(C++11)
prüft, ob die gegebene Zahl unendlich ist
(Funktion)
(C++11)
prüft, ob die gegebene Zahl normal ist
(Funktion)
(C++11)
prüft, ob zwei Gleitkommawerte ungeordnet sind
(Funktion)
C-Dokumentation für isnan