Ceil

定义于头文件 <cmath> 中。

描述

计算不小于 num 的最小整数值。库为所有 cv-不限定的浮点类型提供了 std::ceil 的重载，作为参数 num 的类型  (C++23 起)。
为所有整数类型提供了额外的重载，这些类型被视为 double (C++11 起).

声明

C++23

// 1)
constexpr /* floating-point-type */ ciel( /* floating-point-type */ num );
// 2)
constexpr float cielf( float num );
// 3)
constexpr long double ciell( long double num );

附加重载

// 4)
template< class Integer >
constexpr double ciel ( Integer num );

C++11

// 1)
float ciel ( float num );
// 2)
double ciel ( double num );
//3)
long double ciel ( long double num );
// 4)
float erfcf( float num );
// 5)
long double erfcl( long double num );

附加重载

// 6)
template< class Integer >
double ciel ( Integer num );

参数

​num - 浮点或整数值

返回值

如果没有错误发生，返回不小于 num 的最小整数值，即 ⌈num⌉。

错误处理

错误按 math_errhandling 中指定的方式报告。

如果实现支持 IEEE 浮点运算（IEC 60559）

当前的舍入模式无效。
如果 num 是 ±∞，则返回未修改的值
如果 num 是 ±0，则返回未修改的值
如果 num 是 NaN，则返回 NaN

备注

当舍入非整数有限值时，可能会（但不要求）引发 FE_INEXACT。

在所有标准浮点格式中，最大的可表示浮点值都是精确整数，因此此函数本身永远不会溢出；但是，当存储在整数变量中时，结果可能会溢出任何整数类型（包括 std::intmax_t）。正是出于这个原因，返回类型是浮点而不是整数。

此函数（对于 double 参数）的行为如同（除了不引发 FE_INEXACT 的自由）由以下代码实现

#include <cfenv>
#include <cmath>
 
#pragma STDC FENV_ACCESS ON
 
double ceil(double x)
{
    int save_round = std::fegetround();
    std::fesetround(FE_UPWARD);
    double result = std::rint(x); // or std::nearbyint
    std::fesetround(save_round);
    return result;
}

额外的重载不需要完全按照额外重载提供。它们只需要足以确保对于其整数类型的参数 num，
std::ceil(num) 具有与 std::ceil(static_cast<double>(num)) 相同的效果。

示例

#include <cmath>
#include <iostream>
 
int main()
{
    std::cout 
        << std::fixed
        << "ceil(+2.4) = " 
        << std::ceil(+2.4) << '\n'
        << "ceil(-2.4) = " 
        << std::ceil(-2.4) << '\n'
        << "ceil(-0.0) = " 
        << std::ceil(-0.0) << '\n'
        << "ceil(-Inf) = " 
        << std::ceil(-INFINITY) << '\n';
}

结果

ceil(+2.4) = 3.000000
ceil(-2.4) = -2.000000
ceil(-0.0) = -0.000000
ceil(-Inf) = -inf