nearbyint - округление до
nearbyint(3)
округление до
Other Alias
nearbyintf, nearbyintl, rint, rintf, rintl
ОБЗОР
#include <math.h>
double nearbyint(double x);
float nearbyintf(float x);
long double nearbyintl(long double x);
double rint(double x);
float rintf(float x);
long double rintl(long double x);
Компонуется при указании параметра -lm.
Требования макроса тестирования свойств для glibc
(см. feature_test_macros(7)):
nearbyint(), nearbyintf(), nearbyintl():
_XOPEN_SOURCE >= 600 || _POSIX_C_SOURCE >= 200112L ||
_ISOC99_SOURCE;
или
cc -std=c99
rint():
_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 500 || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED || _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L;
или
cc -std=c99
rintf(),
rintl():
_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 600 || _ISOC99_SOURCE
|| _POSIX_C_SOURCE >= 200112L;
или
cc -std=c99
ОПИСАНИЕ
Функции
nearbyint(),
nearbyintf() и
nearbyintl() округляют
переданный аргумент до целого значения в формате с плавающей запятой в
соответствии с текущим направлением округления (смотрите
fesetround(3)) и
не генерируют исключение о
неточности. Когда текущее округление
направлено к ближайшему целому, то в случае нахождения посереди между
значениями эти функции округляют до чётного целого, в соответствии с
IEEE-754.
Функции rint(), rintf() и rintl() делают то же самое, но генерируют
исключение о неточности (FE_INEXACT, проверяется с помощью
fetestexcept(3)), если результат отличается в значении от аргумента.
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
Данные функции возвращают округлённое целое число.
Если x целое, +0, -0, NaN или стремится к бесконечности, то будет
возвращено значение x.
ОШИБКИ
Ошибки не возникают. В документах POSIX.1-2001 описывается ошибка диапазона
при переполнениях, однако смотрите
ЗАМЕЧАНИЯ.
АТРИБУТЫ
Описание терминов данного раздела смотрите в
attributes(7).
Интерфейс Атрибут Значение
nearbyint(),
nearbyintf(),
nearbyintl(),
rint(),
rintf(),
rintl()
безвредность в потоках: безвредно (MT-Safe)
СООТВЕТСТВИЕ СТАНДАРТАМ
C99, POSIX.1-2001, POSIX.1-2008.
ЗАМЕЧАНИЯ
В SUSv2 и POSIX.1-2001 есть текст о переполнении (которое может установить
errno в
ERANGE или вызвать исключение
FE_OVERFLOW). На практике,
результат не может выйти за диапазон ни на каком компьютере, поэтому
обработка этой ошибки не имеет смысла (точнее говоря, переполнение возможно
только в том случае, когда максимальное значение экспоненты меньше числа бит
мантиссы. В стандарте IEEE-754 для 32- и 64-битных чисел с плавающей точкой
максимальное значение экспоненты равно 128 и 1024 соответственно, а число
бит мантиссы --- 24 и 53 соответственно).
Если вы хотите сохранить округлённое значение в целочисленном типе, то лучше
использовать одну из функций, описанных в lrint(3).
