rint, rintf, rintl

项目
06/09/2015

将浮点值舍入到最接近的整数（采用浮点格式）。

double rint( double x );
float rint( float x );  // C++ only
long double rint( long double x );  // C++ only
float rintf( float x ); 
long double rintl( long double x );

参数

x
要舍入的浮点值。

返回值

rint 函数将返回表示最接近 x 的整数的浮点值。与 nearbyint 函数相同，根据浮点舍入模式的当前设置对中间值进行舍入。与 nearbyint 函数不同，如果结果不同于参数中的值，则 rint 函数可能会引起 FE_INEXACT 浮点异常。无错误返回。

输入	SEH 异常	_matherr 异常
± ∞、QNAN、IND	无	无
非规格化数	EXCEPTION_FLT_UNDERFLOW	无

备注

由于 C++ 允许重载，因此你可以调用采用并返回 float 和 long double 值的 rint 重载。在 C 程序中，rint 始终采用并返回 double。

要求

函数	C 标头	C++ 标头
rint, rintf, rintl	<math.h>	<cmath>

有关其他兼容性信息，请参见兼容性。

示例

// crt_rint.c
// Build with: cl /W3 /Tc crt_rint.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("rint(%f) is %.0f\n", x, rint (x));
   printf("rint(%f) is %.0f\n", -x, rint (-x));
   printf("rintf(%f) is %.0f\n", y, rintf(y));
   printf("rintf(%f) is %.0f\n", -y, rintf(-y));
   printf("rintl(%Lf) is %.0Lf\n", z, rintl(z));
   printf("rintl(%Lf) is %.0Lf\n", -z, rintl(-z));
}