fpclassify

 

C

Compiler-Unterstützung

Sprache

Header

Typunterstützung

Programm-Dienstprogramme

Unterstützung für variable Funktionsargumente

Fehlerbehandlung

Dynamische Speicherverwaltung

Bibliothek für Zeichenketten

Algorithmen

Numerik

Datums- und Zeitdienstprogramme

Ein-/Ausgabeunterstützung

Lokalisierungsunterstützung

Unterstützung für Nebenläufigkeit (C11)

Technische Spezifikationen

Symbolindex

 

Numerik

Allgemeine mathematische Funktionen

Gleitkomma-Umgebung (C99)

Pseudozufallszahlengenerierung

Komplexe Arithmetik (C99)

Typ-generierte Mathematik (C99)

Bitmanipulation (C23)

Geprüfte Ganzzahl-Arithmetik (C23)

 

Allgemeine mathematische Funktionen

Funktionen Grundlegende Operationen abslabsllabsimaxabs (C99)(C99) fabs divldivlldivimaxdiv (C99)(C99) fmod remainder (C99) remquo (C99) fma (C99) fdim (C99) nannanfnanlnandN (C99)(C99)(C99)(C23) Maximum/Minimum-Operationen fmax (C99) fmin (C99) fmaximum (C23) fminimum (C23) fmaximum_mag (C23)  fmaximum_num (C23) fminimum_mag (C23) fminimum_num (C23) fmaximum_mag_num (C23) fminimum_mag_num (C23)   Exponentialfunktionen exp exp10 (C23) exp2 (C99) expm1 (C99) exp10m1 (C23) exp2m1 (C23) log log10 log2 (C99) log1plogp1 (C99)(C23) log10p1 (C23) log2p1 (C23) Potenzfunktionen sqrt cbrt (C99) rootn (C23) rsqrt (C23) hypot (C99) compound (C23) pow pown (C23) powr (C23) Trigonometrische und hyperbolische Funktionen sin cos tan asin acos atan atan2 sinpi (C23) cospi (C23) tanpi (C23) asinpi (C23) acospi (C23) atanpi (C23) atan2pi (C23) sinh cosh tanh asinh (C99) acosh (C99) atanh (C99)

Nächste ganze Gleitkommazahlen ceil floor roundlroundllround (C99)(C99)(C99) roundeven (C23) trunc (C99) nearbyint (C99) rintlrintllrint (C99)(C99)(C99) fromfpfromfpxufromfpufromfpx (C23)(C23)(C23)(C23) Gleitkomma-Manipulation ldexp frexp scalbnscalbln (C99)(C99) ilogbllogb (C99)(C23) logb (C99) modf nextafternexttoward (C99)(C99) nextupnextdown (C23)(C23) copysign (C99) canonicalize (C23) Verengende Operationen fadd (C23) fsub (C23) fmul (C23) fdiv (C23) ffma (C23) fsqrt (C23) Quanten- und Quantenexponent-Funktionen quantizedN (C23) quantumdN (C23) samequantumdN (C23) llquantexpdN (C23) Dezimal-Neu-Kodierungsfunktionen encodedecdN (C23) decodedecdN (C23) encodebindN (C23) decodebindN (C23) Gesamtordnung und Payload-Funktionen totalorder (C23) getpayload (C23) setpayload (C23) setpayloadsig (C23) Klassifizierung fpclassify (C99) iscanonical (C23)  isfinite (C99) isinf (C99) isnan (C99) isnormal (C99) signbit (C99) issubnormal (C23) iszero (C23) isgreater (C99) isgreaterequal (C99)   isless (C99) islessequal (C99) islessgreater (C99) isunordered (C99) issignaling (C23) iseqsig (C23)

Fehler- und Gammafunktionen erf (C99) erfc (C99) lgamma (C99) tgamma (C99) Typen div_tldiv_tlldiv_timaxdiv_t (C99)(C99) float_tdouble_t (C99)(C99) _Decimal32_t_Decimal64_t (C23)(C23) Makrokonstanten Spezielle Gleitkommawerte HUGE_VALHUGE_VALFHUGE_VALLHUGE_VALDN (C99)(C99)(C23) INFINITYDEC_INFINITY (C99)(C23) NANDEC_NAN (C99)(C23) Argumente und Rückgabewerte FP_ILOGB0FP_ILOGBNAN (C99)(C99) FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C99)(C99)(C99)(C99)(C99) FP_LLOGB0FP_LLOGBNAN (C23)(C23) FP_INT_UPWARDFP_INT_DOWNWARDFP_INT_TOWARDZEROFP_INT_TONEARESTFROMZEROFP_INT_TONEAREST (C23)(C23)(C23)(C23)(C23) Fehlerbehandlung MATH_ERRNOMATH_ERRNOEXCEPT (C99)(C99)  math_errhandling (C99) Schnelle Operationsanzeigen FP_FAST_FMAFFP_FAST_FMA (C99)(C99) FP_FAST_FADDFP_FAST_FADDLFP_FAST_DADDLFP_FAST_DMADDDN (C23)(C23)(C23)(C23) FP_FAST_FMULFP_FAST_FMULLFP_FAST_DMULLFP_FAST_DMMULDN (C23)(C23)(C23)(C23) FP_FAST_FFMAFP_FAST_FFMALFP_FAST_DFMALFP_FAST_DMFMADN (C23)(C23)(C23)(C23) FP_FAST_FMALFP_FAST_FMADN (C99)(C23) FP_FAST_FSUBFP_FAST_FSUBLFP_FAST_DSUBLFP_FAST_DMSUBDN (C23)(C23)(C23)(C23) FP_FAST_FDIVFP_FAST_FDIVLFP_FAST_DDIVLFP_FAST_DMDIVDN (C23)(C23)(C23)(C23) FP_FAST_FSQRTFP_FAST_FSQRTLFP_FAST_DSQRTLFP_FAST_DMSQRTDN (C23)(C23)(C23)(C23)

 

Definiert in Header <math.h>
#define fpclassify(arg) /* implementierungsabhängig */		(seit C99)

Kategorisiert den Gleitkommawert arg in die folgenden Kategorien: Null, Subnormal, Normal, Unendlich, NAN oder eine implementierungsabhängige Kategorie. Das Makro gibt einen ganzzahligen Wert zurück.

FLT_EVAL_METHOD wird ignoriert: Selbst wenn das Argument mit mehr Wertebereich und Präzision als sein Typ ausgewertet wird, wird es zuerst in seinen semantischen Typ konvertiert und die Klassifizierung basiert darauf: Ein normaler long-double-Wert kann subnormal werden, wenn er in double konvertiert wird, und null, wenn er in float konvertiert wird.

Parameter

arg

-

Gleitkommawert

Rückgabewert

Einer von FP_INFINITE, FP_NAN, FP_NORMAL, FP_SUBNORMAL, FP_ZERO oder einem implementierungsabhängigen Typ, der die Kategorie von arg angibt.

Beispiel

Führen Sie diesen Code aus

#include <float.h>
#include <math.h>
#include <stdio.h>
 
const char* show_classification(double x)
{
    switch(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(void)
{
    printf("1.0/0.0 is %s\n", show_classification(1 / 0.0));
    printf("0.0/0.0 is %s\n", show_classification(0.0 / 0.0));
    printf("DBL_MIN/2 is %s\n", show_classification(DBL_MIN / 2));
    printf("-0.0 is %s\n", show_classification(-0.0));
    printf("1.0 is %s\n", show_classification(1.0));
}

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

Referenzen

• C23-Standard (ISO/IEC 9899:2024)

• 7.12.3.1 Das fpclassify-Makro (S. TBD)

• C17-Standard (ISO/IEC 9899:2018)

• 7.12.3.1 Das fpclassify-Makro (S. TBD)

• C11-Standard (ISO/IEC 9899:2011)

• 7.12.3.1 Das fpclassify-Makro (S. 235)

• C99-Standard (ISO/IEC 9899:1999)

• 7.12.3.1 Das fpclassify-Makro (S. 216)

Siehe auch

isfinite (C99)	prüft, ob die gegebene Zahl endlich ist (Funktionsmakro)
isinf (C99)	prüft, ob die gegebene Zahl unendlich ist (Funktionsmakro)
isnan (C99)	prüft, ob die gegebene Zahl NaN ist (Funktionsmakro)
isnormal (C99)	prüft, ob die gegebene Zahl normal ist (Funktionsmakro)
C++ Dokumentation für fpclassify