floor, floorf, floorl

 

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>
float       floorf( float arg );	(1)	(seit C99)
double      floor( double arg );	(2)
long double floorl( long double arg );	(3)	(seit C99)
Definiert in Header <tgmath.h>
#define floor( arg )	(4)	(seit C99)

1-3) Berechnet den größten ganzzahligen Wert, der nicht größer als arg ist.

4) Typ-generische Makro: Wenn arg den Typ long double hat, wird floorl aufgerufen. Andernfalls, wenn arg einen ganzzahligen Typ oder den Typ double hat, wird floor aufgerufen. Andernfalls wird floorf aufgerufen.

Parameter

arg

-

Gleitkommawert

Rückgabewert

Wenn keine Fehler auftreten, wird der größte ganzzahlige Wert zurückgegeben, der nicht größer als arg ist, d.h. ⌊arg⌋.

Rückgabewert

Argument

Fehlerbehandlung

Fehler werden wie in math_errhandling angegeben gemeldet.

Wenn die Implementierung IEEE-Gleitkomma-Arithmetik (IEC 60559) unterstützt

• Der aktuelle Rundungsmodus hat keine Auswirkung.
• Wenn arg ±∞ ist, wird es unverändert zurückgegeben.
• Wenn arg ±0 ist, wird es unverändert zurückgegeben.
• Wenn arg NaN ist, wird NaN zurückgegeben.

Hinweise

FE_INEXACT kann ausgelöst werden (ist aber nicht zwingend erforderlich), wenn ein endlicher Nicht-Ganzzahlwert gerundet wird.

Die größten darstellbaren Gleitkommazahlen sind in allen Standard-Gleitkommaformaten exakte ganze Zahlen, daher kann diese Funktion für sich allein niemals überlaufen; das Ergebnis kann jedoch jeden Ganzzahltyp (einschließlich intmax_t) überlaufen, wenn es in einer Ganzzahlvariablen gespeichert wird.

Beispiel

Führen Sie diesen Code aus

#include <math.h>
#include <stdio.h>
 
int main(void)
{
    printf("floor(+2.7) = %+.1f\n", floor(2.7));
    printf("floor(-2.7) = %+.1f\n", floor(-2.7));
    printf("floor(-0.0) = %+.1f\n", floor(-0.0));
    printf("floor(-Inf) = %+f\n",   floor(-INFINITY));
}

Mögliche Ausgabe

floor(+2.7) = +2.0
floor(-2.7) = -3.0
floor(-0.0) = -0.0
floor(-Inf) = -inf

Referenzen

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

• 7.12.9.2 Die floor-Funktionen (S. TBD)

• 7.25 Typ-generische Mathematik <tgmath.h> (S. TBD)

• F.10.6.2 Die floor-Funktionen (S. TBD)

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

• 7.12.9.2 Die floor-Funktionen (S. TBD)

• 7.25 Typ-generische Mathematik <tgmath.h> (S. TBD)

• F.10.6.2 Die floor-Funktionen (S. TBD)

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

• 7.12.9.2 Die floor-Funktionen (S. 251)

• 7.25 Typ-generische Mathematik <tgmath.h> (S. 373-375)

• F.10.6.2 Die floor-Funktionen (S. 526)

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

• 7.12.9.2 Die floor-Funktionen (S. 232)

• 7.22 Typ-generische Mathematik <tgmath.h> (S. 335-337)

• F.9.6.2 Die floor-Funktionen (S. 463)

• C89/C90-Standard (ISO/IEC 9899:1990)

• 4.5.6.3 Die floor-Funktion

Siehe auch

ceilceilfceill (C99)(C99)	berechnet die kleinste ganze Zahl, die nicht kleiner als der gegebene Wert ist (Funktion)
trunctruncftruncl (C99)(C99)(C99)	rundet auf die größte ganze Zahl, deren Betrag nicht größer als der gegebene Wert ist (Funktion)
roundroundfroundllroundlroundflroundlllroundllroundfllroundl (C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99)	rundet auf die nächste ganze Zahl, wobei bei Halb-Wert-Fällen von Null weg gerundet wird (Funktion)
C++-Dokumentation für floor