命名空间
变体
操作

ceil, ceilf, ceill

来自 cppreference.cn
< c‎ | 数值‎ | 数学
 
 
 
常用数学函数
函数
基本操作
(C99)
(C99)
(C99)
(C99)(C99)(C99)(C23)
最大值/最小值操作
(C99)
(C99)
指数函数
(C23)
(C99)
(C99)
(C23)
(C23)

(C99)
(C99)(C23)
(C23)
(C23)
幂函数
(C99)
(C23)
(C23)

(C99)
(C23)
(C23)
三角函数和双曲函数
(C23)
(C23)
(C23)
(C23)
(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)
(C99)
(C99)
(C99)
类型
宏常量
特殊浮点值
(C99)(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-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