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); // 或 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 The ceil functions (第 TBD 页)
  • 7.25 Type-generic math <tgmath.h> (第 TBD 页)
  • F.10.6.1 The ceil functions (第 TBD 页)
  • C17 标准(ISO/IEC 9899:2018):
  • 7.12.9.1 The ceil functions (第 TBD 页)
  • 7.25 Type-generic math <tgmath.h> (第 TBD 页)
  • F.10.6.1 The ceil functions (第 TBD 页)
  • C11 标准(ISO/IEC 9899:2011):
  • 7.12.9.1 The ceil functions (第 251 页)
  • 7.25 Type-generic math <tgmath.h> (第 373-375 页)
  • F.10.6.1 The ceil functions (第 526 页)
  • C99 标准(ISO/IEC 9899:1999):
  • 7.12.9.1 The ceil functions (第 231-232 页)
  • 7.22 Type-generic math <tgmath.h> (第 335-337 页)
  • F.9.6.1 The ceil functions (第 462-463 页)
  • C89/C90 标准(ISO/IEC 9899:1990):
  • 4.5.6.1 The ceil function

参阅

计算不大于给定值的最大整数
(函数)
(C99)(C99)(C99)
取整到绝对值不大于给定值的最接近整数
(函数)
(C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99)
取整到最接近的整数,在相邻整数正中间时取远离零的数
(函数)
用当前舍入模式取整到整数
(函数)
(C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99)(C99)
使用当前舍入模式取整到整数,若结果有误则产生异常
(函数)