std::isunordered

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Numerik-Bibliothek

Allgemeine mathematische Funktionen
Mathematische Spezialfunktionen (C++17)
Mathematische Konstanten (C++20)
Grundlegende lineare Algebra-Algorithmen (C++26)
Datenparallele Typen (SIMD) (C++26)
Gleitkomma-Umgebung (C++11)
Komplexe Zahlen
Numerische Arrays (valarray)
Pseudozufallszahlengenerierung
Bit-Manipulation (C++20)
Faktoroperationen
gcd (C++17)	lcm (C++17)
Interpolationen
midpoint (C++20)	lerp (C++20)
Sättigungsarithmetik
add_sat (C++26) sub_sat (C++26) saturate_cast (C++26)	mul_sat (C++26) div_sat (C++26)
Generische numerische Operationen
iota (C++11) ranges::iota (C++23) accumulate inner_product adjacent_difference    partial_sum	reduce (C++17) transform_reduce (C++17) inclusive_scan (C++17) exclusive_scan (C++17) transform_inclusive_scan (C++17) transform_exclusive_scan (C++17)

 

Allgemeine mathematische Funktionen

Funktionen
Grundlegende Operationen
abs(int)labsllabsimaxabs (C++11)   abs(float)fabs divldivlldivimaxdiv (C++11)	fmod remainder (C++11)   remquo (C++11) fma (C++11) fmax (C++11) fmin (C++11) fdim (C++11) nannanfnanl (C++11)(C++11)(C++11)
Exponentialfunktionen
exp exp2 (C++11) expm1 (C++11)	log log10 log1p (C++11) log2 (C++11)
Potenzfunktionen
sqrt cbrt (C++11)	hypot (C++11) pow
Trigonometrische und hyperbolische Funktionen
sin cos tan asin acos atan atan2	sinh cosh tanh asinh (C++11) acosh (C++11) atanh (C++11)
Fehler- und Gammafunktionen
erf (C++11) erfc (C++11)	lgamma (C++11) tgamma (C++11)

Rundungsoperationen für Gleitkommazahlen
ceil floor roundlroundllround (C++11)(C++11)(C++11)	trunc (C++11) nearbyint (C++11) rintlrintllrint (C++11)(C++11)(C++11)
Gleitkomma-Manipulationsfunktionen
ldexp scalbnscalbln (C++11)(C++11) ilogb (C++11) logb (C++11)	frexp modf nextafternexttoward (C++11)(C++11) copysign (C++11)
Klassifizierung und Vergleich
fpclassify (C++11) isfinite (C++11) isinf (C++11) isnan (C++11) isnormal (C++11) signbit (C++11)	isgreater (C++11) isgreaterequal (C++11) isless (C++11) islessequal (C++11) islessgreater (C++11) isunordered (C++11)
Typen
div_t ldiv_t lldiv_t (C++11)	imaxdiv_t (C++11) float_t (C++11) double_t (C++11)
Makrokonstanten
HUGE_VALFHUGE_VALHUGE_VALL (C++11)(C++11) math_errhandlingMATH_ERRNOMATH_ERREXCEPT (C++11)   INFINITY (C++11) NAN (C++11)	Klassifizierung FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C++11)(C++11)(C++11)(C++11)(C++11)

 

Definiert in der Header-Datei <cmath>
	(1)
bool isunordered( float x, float y ); bool isunordered( double x, double y ); bool isunordered( long double x, long double y );			(seit C++11) (bis C++23)
constexpr bool isunordered( /* floating-point-type */ x,                             /* floating-point-type */ y );			(seit C++23)
Zusätzliche Überladungen
Definiert in der Header-Datei <cmath>
template< class Arithmetic1, class Arithmetic2 > bool isunordered( Arithmetic1 x, Arithmetic2 y );		(A)	(seit C++11) (constexpr seit C++23)

1) Ermittelt, ob die Gleitkommazahlen x und y ungeordnet sind, d. h. eine oder beide sind NaN und können daher nicht sinnvoll miteinander verglichen werden.Die Bibliothek stellt Überladungen für alle cv-unqualifizierten Gleitkommatypen als Parametertypen x und y bereit.(seit C++23)

A) Zusätzliche Überladungen werden für alle anderen Kombinationen von arithmetischen Typen bereitgestellt.

Parameter

x, y

-

Gleitkomma- oder Ganzzahlwerte

Rückgabewert

true, wenn entweder x oder y NaN ist, false andernfalls.

Anmerkungen

Die zusätzlichen Überladungen müssen nicht exakt wie (A) angegeben werden. Sie müssen nur ausreichen, um sicherzustellen, dass für ihr erstes Argument num1 und ihr zweites Argument num2

Wenn num1 oder num2 vom Typ long double ist, hat std::isunordered(num1, num2) denselben Effekt wie std::isunordered(static_cast<long double>(num1),                  static_cast<long double>(num2)). Andernfalls, wenn num1 und/oder num2 vom Typ double oder einem ganzzahligen Typ sind, hat std::isunordered(num1, num2) denselben Effekt wie std::isunordered(static_cast<double>(num1),                  static_cast<double>(num2)). Andernfalls, wenn num1 oder num2 vom Typ float ist, hat std::isunordered(num1, num2) denselben Effekt wie std::isunordered(static_cast<float>(num1),                  static_cast<float>(num2)).

(bis C++23)

Wenn num1 und num2 arithmetische Typen haben, hat std::isunordered(num1, num2) denselben Effekt wie std::isunordered(static_cast</*gemeinsamer-gleitkomma-typ*/>(num1),                  static_cast</*gemeinsamer-gleitkomma-typ*/>(num2)), wobei /*gemeinsamer-gleitkomma-typ*/ der Gleitkommatyp mit dem höchsten Gleitkomma-Konversionsrang und dem höchsten Gleitkomma-Konversions-Subrang zwischen den Typen von num1 und num2 ist. Argumente vom ganzzahligen Typ werden so behandelt, als hätten sie denselben Gleitkomma-Konversionsrang wie double. Wenn kein solcher Gleitkommazahltyp mit dem höchsten Rang und Subrang existiert, dann führt die Überladungsauflösung nicht zu einem nutzbaren Kandidaten aus den bereitgestellten Überladungen.

(seit C++23)

Beispiel

Führen Sie diesen Code aus

#include <cmath>
#include <iostream>
 
#define SHOW_UNORDERED(x, y) \
    std::cout << std::boolalpha << "isunordered(" \
              << #x << ", " << #y << "): " \
              << std::isunordered(x, y) << '\n'
 
int main()
{
    SHOW_UNORDERED(10, 01);
    SHOW_UNORDERED(INFINITY, NAN);
    SHOW_UNORDERED(INFINITY, INFINITY);
    SHOW_UNORDERED(NAN, NAN);
}

Ausgabe

isunordered(10, 01): false
isunordered(INFINITY, NAN): true
isunordered(INFINITY, INFINITY): false
isunordered(NAN, NAN): true

Siehe auch

fpclassify (C++11)	klassifiziert den gegebenen Gleitkommawert (Funktion)
isnan (C++11)	prüft, ob die gegebene Zahl NaN ist (Funktion)
C-Dokumentation für isunordered