std::ceil, std::ceilf, std::ceill

float       ceil ( float num );
double      ceil ( double num );
long double ceil ( long double num );

constexpr /* floating-point-type */
            ceil ( /* floating-point-type */ num );

float       ceilf( float num );

long double ceill( long double num );

template< class Integer >
double      ceil ( 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;
}

Дополнительные перегрузки не обязаны предоставляться точно как (A). Они должны быть достаточными, чтобы гарантировать, что для своего аргумента 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

См. также

Внешние ссылки