Linux repositories inspector
2017-09-15
Aliases: nearbyint(3), nearbyint(3), nearbyint(3), nearbyint(3), nearbyint(3), nearbyint(3), nearbyint(3), nearbyint(3), nearbyint(3), nearbyint(3), nearbyint(3), nearbyint(3), nearbyintf(3), nearbyintf(3), nearbyintf(3), nearbyintf(3), nearbyintf(3), nearbyintf(3), nearbyintf(3), nearbyintf(3), nearbyintf(3), nearbyintf(3), nearbyintf(3), nearbyintf(3), nearbyintl(3), nearbyintl(3), nearbyintl(3), nearbyintl(3), nearbyintl(3), nearbyintl(3), nearbyintl(3), nearbyintl(3), nearbyintl(3), nearbyintl(3), nearbyintl(3), nearbyintl(3), rintf(3), rintf(3), rintf(3), rintf(3), rintf(3), rintf(3), rintf(3), rintf(3), rintf(3), rintf(3), rintf(3), rintf(3), rintl(3), rintl(3), rintl(3), rintl(3), rintl(3), rintl(3), rintl(3), rintl(3), rintl(3), rintl(3), rintl(3), rintl(3)

man-pages-ru

Russian man pages from the Linux Documentation Project

manpages-dev

Manual pages about using GNU/Linux for development

man-pages

Linux kernel and C library user-space interface documentation

ИМЯ

nearbyint, 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():
_POSIX_C_SOURCE >= 200112L || _ISOC99_SOURCE

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

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

ОПИСАНИЕ

Функции 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).

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

⇧ Top