std::fpclassify

 

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)
int fpclassify( float num ); int fpclassify( double num ); int fpclassify( long double num );			(seit C++11) (bis C++23)
constexpr int fpclassify( /* floating-point-type */ num );			(seit C++23)
Zusätzliche Überladungen
Definiert in der Header-Datei <cmath>
template< class Integer > int fpclassify( Integer num );		(A)	(seit C++11) (constexpr seit C++23)

1) Klassifiziert den Gleitkommawert num in die folgenden Kategorien: Null, Subnormal, Normal, Unendlich, NAN oder eine implementierungsabhängige Kategorie. Die Bibliothek stellt Überladungen von std::fpclassify für alle cv-unqualified Gleitkommatypen als Parametertyp von num bereit.(seit C++23)

A) Zusätzliche Überladungen werden für alle ganzzahligen Typen bereitgestellt, die als double behandelt werden.

Parameter

num

-

Gleitkomma- oder Ganzzahlwert

Rückgabewert

einer der Werte FP_INFINITE, FP_NAN, FP_NORMAL, FP_SUBNORMAL, FP_ZERO oder ein implementierungsabhängiger Typ, der die Kategorie von num angibt.

Hinweise

Die zusätzlichen Überladungen müssen nicht exakt als (A) bereitgestellt werden. Sie müssen nur ausreichen, um sicherzustellen, dass für ihren Argument num vom Integer-Typ, std::fpclassify(num) denselben Effekt hat wie std::fpclassify(static_cast<double>(num)).

Beispiel

Führen Sie diesen Code aus

#include <cfloat>
#include <cmath>
#include <iostream>
 
auto show_classification(double x)
{
    switch (std::fpclassify(x))
    {
        case FP_INFINITE:
            return "Inf";
        case FP_NAN:
            return "NaN";
        case FP_NORMAL:
            return "normal";
        case FP_SUBNORMAL:
            return "subnormal";
        case FP_ZERO:
            return "zero";
        default:
            return "unknown";
    }
}
 
int main()
{
    std::cout << "1.0/0.0 is " << show_classification(1 / 0.0) << '\n'
              << "0.0/0.0 is " << show_classification(0.0 / 0.0) << '\n'
              << "DBL_MIN/2 is " << show_classification(DBL_MIN / 2) << '\n'
              << "-0.0 is " << show_classification(-0.0) << '\n'
              << "1.0 is " << show_classification(1.0) << '\n';
}

Ausgabe

1.0/0.0 is Inf
0.0/0.0 is NaN
DBL_MIN/2 is subnormal
-0.0 is zero
1.0 is normal

Siehe auch

isfinite (C++11)	prüft, ob die gegebene Zahl endlich ist (Funktion)
isinf (C++11)	prüft, ob die gegebene Zahl unendlich ist (Funktion)
isnan (C++11)	prüft, ob die gegebene Zahl NaN ist (Funktion)
isnormal (C++11)	prüft, ob die gegebene Zahl normal ist (Funktion)
numeric_limits	bietet eine Schnittstelle zur Abfrage von Eigenschaften aller fundamentalen numerischen Typen (Klassenschablone)
C-Dokumentation für fpclassify