Linux程序员手册 第3部分
更新日期： 2017-09-15

名称

round，roundf，roundl-舍入到最接近的整数，远离零

语法

#include <math.h>

double round(double x);
float roundf(float x);
long double roundl(long double x);

与-lm链接。

glibc的功能测试宏要求(请参阅feature_test_macros(7))：

round()，roundf()，roundl()：

_ISOC99_SOURCE || _POSIX_C_SOURCE>= 200112L

说明

这些函数将x舍入到最接近的整数，但是将中途情况舍入为零(无论当前舍入方向如何，请参见fenv(3))，而不是舍入到最接近的偶数整数，如rint(3)。

例如，round(0.5)为1.0，round(-0.5)为-1.0。

返回值

这些函数返回舍入的整数值。

如果x为整数，+ 0，-0，NaN或无穷大，则返回x本身。

错误说明

没有错误发生。 POSIX.1-2001记录了溢出的范围错误，但请参阅注意。

版本

这些功能首先出现在2.1版的glibc中。

属性

有关本节中使用的术语的说明，请参见attribute(7)。

遵循规范

C99，POSIX.1-2001，POSIX.1-2008。

备注

POSIX.1-2001包含有关溢出的文本(这可能会将errno设置为ERANGE，或引发FE_OVERFLOW异常)。在实践中，结果不会在任何当前计算机上溢出，因此这种错误处理内容只是胡说八道。 (更确切地说，仅当指数的最大值小于尾数位数时，才可能发生溢出。对于IEEE-754标准的32位和64位浮点数，指数的最大值为128(分别为1024)和尾数位数为24(分别为53)。

如果要将舍入后的值存储为整数类型，则可能要使用lround(3)中描述的函数之一。

另外参见

ceil(3)，floor(3)，lround(3)，neighborint(3)，rint(3)，trunc(3)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本，请访问https://www.kernel.org/doc/man-pages/。