Linux Man на русском

  User    Syst    Libr    Device    Files    Other    Admin  



   ceill - функции округления до наименьшего целого, не меньшего,

ceill(3) функции округления до наименьшего целого, не меньшего,

Other Alias

ceil, ceilf


ОБЗОР

#include <math.h>


double ceil(double x);
float ceilf(float x);
long double ceill(long double x);

Компонуется при указании параметра -lm.

Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

ceilf(), ceill():

_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 600 || _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L;
или cc -std=c99


ОПИСАНИЕ

Данные функции возвращают наименьшее целое значение, но не меньше чем x.

Например, результатом ceil(0.5) будет 1.0, а ceil(-0.5) равно -0.0.


ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

Данные функции возвращают округлённое значение x.

Если x целое, +0, -0, NaN или стремится к бесконечности, то будет возвращено значение x.


ОШИБКИ

Ошибки не возникают. В документах POSIX.1-2001 описывается ошибка диапазона при переполнениях, однако см.
ЗАМЕЧАНИЯ.


АТРИБУТЫ

Описание терминов данного раздела смотрите в attributes(7).

Интерфейс Атрибут Значение
ceil(), ceilf(), ceill() безвредность в потоках: безвредно (MT-Safe)


СООТВЕТСТВИЕ СТАНДАРТАМ

C99, POSIX.1-2001, POSIX.1-2008.

Вариант, возвращающий значение типа double, также соответствует SVr4, 4.3BSD, C89.


ЗАМЕЧАНИЯ

В SUSv2 и POSIX.1-2001 есть текст о переполнении (которое может установить errno в ERANGE или вызвать исключение FE_OVERFLOW). На практике, результат не может выйти за диапазон ни на каком компьютере, поэтому обработка этой ошибки не имеет смысла (точнее говоря, переполнение возможно только в том случае, когда максимальное значение экспоненты меньше числа бит мантиссы. В стандарте IEEE-754 для 32- и 64-битных чисел с плавающей точкой максимальное значение экспоненты равно 128 и 1024 соответственно, а число бит мантиссы — 24 и 53 соответственно).

Целая часть, возвращаемая этими функциями, может быть слишком большой для целого типа (int, long и так далее). Чтобы избежать переполнения, которое может привести к неопределенным результатам, приложение должно осуществлять проверку возвращаемого размера значения до того, как присвоить его целому типу.