ceil, ceilf, ceill

float       ceilf( float arg );

double      ceil( double arg );

long double ceill( long double arg );

#define ceil( arg )

Параметры

Возвращаемое значение

Если ошибок не возникает, возвращается наименьшее целое значение, не меньшее arg, то есть ⌈arg⌉.

Возвращаемое значение

Аргумент

Обработка ошибок

Об ошибках сообщается согласно требованиям 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 (стр.: уточняется)
• 7.25 Обобщённая математика для типов <tgmath.h> (стр.: уточняется)
• F.10.6.1 Функции ceil (стр.: уточняется)
• Стандарт C17 (ISO/IEC 9899:2018):
• 7.12.9.1 Функции ceil (стр.: уточняется)
• 7.25 Обобщённая математика для типов <tgmath.h> (стр.: уточняется)
• F.10.6.1 Функции ceil (стр.: уточняется)
• Стандарт C11 (ISO/IEC 9899:2011):
• 7.12.9.1 Функции ceil (стр.: 251)
• 7.25 Обобщённая математика для типов <tgmath.h> (стр.: 373-375)
• F.10.6.1 Функции ceil (стр.: 526)
• Стандарт C99 (ISO/IEC 9899:1999):
• 7.12.9.1 Функции ceil (стр.: 231-232)
• 7.22 Обобщённая математика для типов <tgmath.h> (стр.: 335-337)
• F.9.6.1 Функции ceil (стр.: 462-463)
• Стандарт C89/C90 (ISO/IEC 9899:1990):
• 4.5.6.1 Функция ceil

См. также