FLOOR(3) Руководство программиста Linux FLOOR(3)

ИМЯ

floor, floorf, floorl - поиск наибольшего целого значения не превышающего заданный аргумент

ОБЗОР

#include <math.h>
double floor(double x);
float floorf(float x);
long double floorl(long double x);

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

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

floorf(), floorl():

_ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L || /* начиная с glibc 2.19: */ _DEFAULT_SOURCE || /* версии glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

ОПИСАНИЕ

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

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

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

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

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

ОШИБКИ

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

АТРИБУТЫ

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

Интерфейс Атрибут Значение
floor(), floorf(), floorl() Безвредность в нитях 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 соответственно).

СМОТРИТЕ ТАКЖЕ

ceil(3), lrint(3), nearbyint(3), rint(3), round(3), trunc(3)

2017-09-15