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

名称

fmod，fmodf，fmodl-浮点余数函数

语法

#include <math.h>

double fmod(double x, double y);
float fmodf(float x, float y);
long double fmodl(long double x, long double y);

与-lm链接。

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

fmodf()，fmodl()：

_ISOC99_SOURCE || _POSIX_C_SOURCE>= 200112L || / *自glibc 2.19起：* / -_DEFAULT_SOURCE || / * Glibc版本

说明

这些函数计算将x除以y的浮点余数。返回值是x-n * y，其中n是x / y的商，朝零舍入为整数。

返回值

成功执行后，这些函数针对某个整数n返回值x-n * y，以使返回的值与x具有相同的符号，并且幅度小于y的幅度。

如果x或y是NaN，则返回NaN。

如果x为无穷大，则会发生域错误，并返回NaN。

如果y为零，则发生域错误，并返回NaN。

如果x为+0(-0)，并且y不为零，则返回+0(-0)。

错误说明

有关如何确定调用这些函数时是否发生错误的信息，请参见math_error(7)。

可能会发生以下错误：

Domain error: xis an infinity

errno设置为EDOM(但请参阅BUGS)。引发了无效的浮点异常(FE_INVALID)。

Domain error: yis zero

errno设置为EDOM。引发了无效的浮点异常(FE_INVALID)。

属性

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

遵循规范

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

返回double的变体还符合SVr4、4.3BSD，C89。

BUGS

在版本2.10之前，当无限x发生域错误时，glibc实现未将errno设置为EDOM。

另外参见

余数(3)

出版信息

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