ceil, ceilf, ceill

 

C

編譯器支援

語言

標頭檔案

型別支援

程式工具

變參函式支援

錯誤處理

動態記憶體管理

字串庫

演算法

數值

日期和時間工具

輸入/輸出支援

本地化支援

併發支援 (C11)

技術規範

符號索引

 

數值

常用數學函式

浮點環境 (C99)

偽隨機數生成

複數運算 (C99)

型別通用數學 (C99)

位操作 (C23)

檢查整數運算 (C23)

 

常用數學函式

函式 基本操作 abslabsllabsimaxabs (C99)(C99) fabs divldivlldivimaxdiv (C99)(C99) fmod remainder (C99) remquo (C99) fma (C99) fdim (C99) nannanfnanlnandN (C99)(C99)(C99)(C23) 最大值/最小值操作 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)   指數函式 exp exp10 (C23) exp2 (C99) expm1 (C99) exp10m1 (C23) exp2m1 (C23) log log10 log2 (C99) log1plogp1 (C99)(C23) log10p1 (C23) log2p1 (C23) 冪函式 sqrt cbrt (C99) rootn (C23) rsqrt (C23) hypot (C99) compound (C23) pow pown (C23) powr (C23) 三角函式和雙曲函式 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)

最近整數浮點數 ceil floor roundlroundllround (C99)(C99)(C99) roundeven (C23) trunc (C99) nearbyint (C99) rintlrintllrint (C99)(C99)(C99) fromfpfromfpxufromfpufromfpx (C23)(C23)(C23)(C23) 浮點數操作 ldexp frexp scalbnscalbln (C99)(C99) ilogbllogb (C99)(C23) logb (C99) modf nextafternexttoward (C99)(C99) nextupnextdown (C23)(C23) copysign (C99) canonicalize (C23) 窄化操作 fadd (C23) fsub (C23) fmul (C23) fdiv (C23) ffma (C23) fsqrt (C23) 量子與量子指數 quantizedN (C23) quantumdN (C23) samequantumdN (C23) llquantexpdN (C23) 十進位制重新編碼函式 encodedecdN (C23) decodedecdN (C23) encodebindN (C23) decodebindN (C23) 總序和載荷函式 totalorder (C23) getpayload (C23) setpayload (C23) setpayloadsig (C23) 分類 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)

誤差函式和伽馬函式 erf (C99) erfc (C99) lgamma (C99) tgamma (C99) 型別 div_tldiv_tlldiv_timaxdiv_t (C99)(C99) float_tdouble_t (C99)(C99) _Decimal32_t_Decimal64_t (C23)(C23) 宏常量 特殊浮點值 HUGE_VALHUGE_VALFHUGE_VALLHUGE_VALDN (C99)(C99)(C23) INFINITYDEC_INFINITY (C99)(C23) NANDEC_NAN (C99)(C23) 引數和返回值 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) 錯誤處理 MATH_ERRNOMATH_ERRNOEXCEPT (C99)(C99)  math_errhandling (C99) 快速操作指示符 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)

 

定義於標頭檔案 <math.h>
float       ceilf( float arg );	(1)	(C99 起)
double      ceil( double arg );	(2)
long double ceill( long double arg );	(3)	(C99 起)
定義於標頭檔案 <tgmath.h>
#define ceil( arg )	(4)	(C99 起)

1-3) 計算不小於 arg 的最小整數值。

4) 泛型宏：若 arg 的型別為 long double，則呼叫 ceill。否則，若 arg 的型別為整數型別或 double，則呼叫 ceil。否則，呼叫 ceilf。

引數

arg

-

浮點值

返回值

如果沒有發生錯誤，返回不小於 arg 的最小整數值，即 ⌈arg⌉。

返回值

引數

錯誤處理

錯誤按 math_errhandling 中指定的方式報告。

如果實現支援 IEEE 浮點算術 (IEC 60559)

• 當前的舍入模式無效。
• 如果 arg 是 ±∞，則返回它，不作修改。
• 如果 arg 是 ±0，則返回它，不作修改。
• 如果 arg 是 NaN，則返回 NaN。

注意

當對非整數有限值進行舍入時，可能會（但非必須）引發 FE_INEXACT。

在所有標準浮點格式中，最大的可表示浮點值都是精確整數，因此此函式本身永遠不會溢位；然而，當儲存到整數變數時，結果可能會溢位任何整數型別（包括 intmax_t）。

此函式（對於 double 引數）的行為如同透過以下方式實現（除了可以不引發 FE_INEXACT）：

#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;
}

示例

執行此程式碼

#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));
}

可能的輸出

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

參考

• C23 標準 (ISO/IEC 9899:2024)

• 7.12.9.1 ceil 函式 (p: TBD)

• 7.25 型別通用數學 <tgmath.h> (p: TBD)

• F.10.6.1 ceil 函式 (p: TBD)

• C17 標準 (ISO/IEC 9899:2018)

• 7.12.9.1 ceil 函式 (p: TBD)

• 7.25 型別通用數學 <tgmath.h> (p: TBD)

• F.10.6.1 ceil 函式 (p: TBD)

• C11 標準 (ISO/IEC 9899:2011)

• 7.12.9.1 ceil 函式 (p: 251)

• 7.25 型別通用數學 <tgmath.h> (p: 373-375)

• F.10.6.1 ceil 函式 (p: 526)

• C99 標準 (ISO/IEC 9899:1999)

• 7.12.9.1 ceil 函式 (p: 231-232)

• 7.22 型別通用數學 <tgmath.h> (p: 335-337)

• F.9.6.1 ceil 函式 (p: 462-463)

• C89/C90 標準 (ISO/IEC 9899:1990)

• 4.5.6.1 ceil 函式

參閱

floorfloorffloorl (C99)(C99)	計算不大於給定值的最大整數 (函式)
trunctruncftruncl (C99)(C99)(C99)	將數字截斷到最接近的整數，其絕對值不大於給定值 (函式)
roundroundfroundllroundlroundflroundlllroundllroundfllroundl (C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99)	四捨五入到最接近的整數，在半數情況下遠離零 (函式)
nearbyintnearbyintfnearbyintl (C99)(C99)(C99)	使用當前舍入模式四捨五入到整數 (函式)
rintrintfrintllrintlrintflrintlllrintllrintfllrintl (C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99)	使用當前舍入模式四捨五入到整數 如果結果不同則丟擲異常 (函式)
C++ 文件 為 ceil