nearbyint, , nearbyintfnearbyintl

Округляет заданное значение с плавающей запятой до целого числа и возвращает это значение в формате с плавающей запятой.

Синтаксис

double nearbyint( double x );
float nearbyintf( float x );
long double nearbyintl( long double x );
#define nearbyint( X ) // Requires C11 or higher

float nearbyint( float x ); //C++ only
long double nearbyint( long double x ); //C++ only

Параметры

x
Значение для округления.

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

При успешном выполнении возвращается xокругление до ближайшего целого числа, используя текущий формат округления, как сообщается fegetround. В противном случае функция может вернуть одно из следующих значений:

Проблема	Возврат
x = ±INFINITY	±INFINITY, не изменено
x = ±0	±0, не изменено
x = не число	Не число

Ошибки не передаются через; в частности, эта функция не сообщает _matherrо каких-либо FE_INEXACT исключениях.

Замечания

Основное различие между этой функцией и rint заключается в том, что эта функция не вызывает исключение с плавающей запятой.

Так как максимальные значения с плавающей запятой являются точными целыми числами, эта функция никогда не будет переполняться сама по себе; вместо этого выходные данные могут привести к переполнению возвращаемого значения в зависимости от используемой функции.

C++ допускает перегрузку, поэтому можно вызывать перегрузки nearbyint, которые принимают и возвращают параметры float или long double. Если вы не используете <макрос tgmath.h> для вызова этой функции nearbyint , всегда принимает два двойных значения и возвращает двойное значение.

Если вы используете <макрос tgmath.h>nearbyint() , тип аргумента определяет, какая версия функции выбрана. Дополнительные сведения см . в разделе "Математика с универсальным типом".

По умолчанию глобальное состояние этой функции ограничивается приложением. Чтобы изменить это поведение, см . статью "Глобальное состояние" в CRT.

Требования

Function	Заголовок C	Заголовок C++
nearbyint, , nearbyintfnearbyintl	<math.h>	<cmath> или <math.h>
nearbyintМакрос	<tgmath.h>

Дополнительные сведения о совместимости см. в разделе Совместимость.

См. также

Справочник по алфавитной функции
Поддержка математических и плавающих точек