命名空间
变体
操作

ceil、ceilf、ceill

来自 cppreference.com
< c‎ | numeric‎ | math
 
 
 
常用数学函数
类型
(C99)(C99)    

(C99)(C99)    

函数
基本运算
(C99)
(C99)
(C99)
(C99)(C99)(C99)(C23)
最大值/最小值运算
(C99)
(C23)    
指数函数
(C23)
(C99)
(C99)
(C23)
(C23)
(C99)
(C99)(C23)
(C23)
(C23)
幂函数
(C99)
(C23)
(C23)
(C99)
(C23)
(C23)
三角函数和双曲函数
(C23)
(C23)
(C23)
(C23)
(C99)
(C99)
(C99)
误差和伽马函数
(C99)
(C99)
(C99)
(C99)
最接近整数的浮点运算
ceil
(C99)(C99)(C99)
(C99)
(C99)(C99)(C99)
(C23)(C23)(C23)(C23)
浮点操作函数
(C99)(C99)
(C99)(C23)
(C99)
缩窄运算
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
量子和量子指数函数
十进制重新编码函数
全序和有效载荷函数
分类
(C99)
(C99)
(C99)
(C23)
宏常量
特殊浮点值
(C99)(C23)
参数和返回值
(C99)(C99)(C99)(C99)(C99)    
错误处理
(C99)    

 
定义在头文件 <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-ceil.svg
参数

[编辑] 错误处理

错误如 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 函数

[编辑] 另请参见

计算不超过给定值的最大整数
(函数) [编辑]
(C99)(C99)(C99)
舍入到最接近的整数,其绝对值不超过给定值
(函数) [编辑]
(C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99)
舍入到最接近的整数,在半途情况下远离零舍入
(函数) [编辑]
使用当前舍入模式舍入到整数
(函数) [编辑]
(C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99)
使用当前舍入模式舍入到整数,如果结果不同则会
产生异常
(函数) [编辑]
C++ 文档 针对 ceil