ceil, ceilf, ceill

 

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

1-3) Berechnet den kleinsten ganzzahligen Wert, der nicht kleiner als arg ist.

4) Typ-generische Makrofunktion: Wenn arg den Typ long double hat, wird ceill aufgerufen. Andernfalls, wenn arg einen Ganzzahltyp oder den Typ double hat, wird ceil aufgerufen. Andernfalls wird ceilf aufgerufen.

Parameter

arg

-

Gleitkommawert

Rückgabewert

Wenn keine Fehler auftreten, wird der kleinste ganzzahlige Wert zurückgegeben, der nicht kleiner als arg ist, also ⌈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 (muss aber nicht), wenn ein nicht-ganzzahliger endlicher Wert 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.

Diese Funktion (für ein double-Argument) verhält sich, als ob sie implementiert wäre durch (mit Ausnahme der Freiheit, FE_INEXACT nicht auszulösen):

#include <fenv.h>
#include <math.h>
#pragma STDC FENV_ACCESS ON
 
double ceil(double x)
{
    double result;
    int save_round = fegetround();
    fesetround(FE_UPWARD);
    result = rint(x); // or nearbyint
    fesetround(save_round);
    return result;
}

Beispiel

Führen Sie diesen Code aus

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

Mögliche Ausgabe

ceil(+2.4) = +3.0
ceil(-2.4) = -2.0
ceil(-0.0) = -0.0
ceil(-Inf) = -inf

Referenzen

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

• 7.12.9.1 The ceil functions (S. TBD)

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

• F.10.6.1 The ceil functions (S. TBD)

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

• 7.12.9.1 The ceil functions (S. TBD)

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

• F.10.6.1 The ceil functions (S. TBD)

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

• 7.12.9.1 The ceil functions (S. 251)

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

• F.10.6.1 The ceil functions (S. 526)

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

• 7.12.9.1 The ceil functions (S. 231-232)

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

• F.9.6.1 The ceil functions (S. 462-463)

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

• 4.5.6.1 The ceil function

Siehe auch

floorfloorffloorl (C99)(C99)	berechnet die größte ganze Zahl, die nicht größer 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)
nearbyintnearbyintfnearbyintl (C99)(C99)(C99)	rundet auf eine ganze Zahl gemäß der aktuellen Rundungsregel (Funktion)
rintrintfrintllrintlrintflrintlllrintllrintfllrintl (C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99)	rundet auf eine ganze Zahl gemäß der aktuellen Rundungsregel mit Ausnahme, wenn das Ergebnis abweicht (Funktion)
C++-Dokumentation für ceil