round, roundf, roundl

Статья
06/09/2015

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

double round( 
   double x 
);
float round(
   float x
);  // C++ only
long double round(
   long double x
);  // C++ only
float roundf(
   float x
);
long double roundl(
   long double x
);

Параметры

x
Значение с плавающей запятой для округления.

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

Функции round возвращают значение с плавающей запятой, представляющее ближайшее к x целое число. значения посередине округляются дальше от нуля, вне зависимости от настройки округления чисел с плавающей запятой. Нет какого-либо возврата ошибки.

Ввод	Исключение SEH	Исключение Matherr
± QNAN,IND	Нет	_DOMAIN

Заметки

Поскольку C++ допускает перегрузки, можно вызывать перегрузки round, принимающие и возвращающие значения float и long double. В программе C round всегда принимает и возвращает double.

Требования

Подпрограмма	Обязательный заголовок
round, roundf, roundl	<math.h>

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

Пример

// crt_round.c
// Build with: cl /W3 /Tc crt_round.c
// This example displays the rounded results of
// the floating-point values 2.499999, -2.499999, 
// 2.8, -2.8, 2.5 and -2.5.

#include <math.h>
#include <stdio.h>

int main( void )
{
   double x = 2.499999;
   float y = 2.8f;
   long double z = 2.5;

   printf("round(%f) is %.0f\n", x, round(x));
   printf("round(%f) is %.0f\n", -x, round(-x));
   printf("roundf(%f) is %.0f\n", y, roundf(y));
   printf("roundf(%f) is %.0f\n", -y, roundf(-y));
   printf("roundl(%Lf) is %.0Lf\n", z, roundl(z));
   printf("roundl(%Lf) is %.0Lf\n", -z, roundl(-z));
}