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< /*math-floating-point*/ V >
constexpr /*deduced-simd-t*/<V> 
            ceil ( const V& v_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

См. также

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