fmod
fmod, fmodf, fmodl
| 在头文件 | | |
|---|---|---|
| float fmodf（float x，float y）; | (1) | （自C99以来） |
| double fmod（double x，double y）; | (2) | |
| long double fmodl（long double x，long double y）; | (3) | （自C99以来） |
| 在头文件<tgmath.h>中定义 | | |
| #define fmod（x，y） | (4) | （自C99以来） |
1-3）计算除法运算x / y的浮点余数。
4）类型 - 泛型宏：如果任何参数的类型为long double，则调用fmodl。 否则，如果任何参数具有整数类型或类型为double，则调用fmod。 否则，调用fmodf。
由该函数计算的除法运算x / y的浮点余数正好是值x-n * y，其中n是x / y，其小数部分被截断。
返回的值与x具有相同的符号，并且在幅度上小于或等于y。
参数
| x, y | - | floating point values |
|---|
返回值
如果成功，返回如上定义的除法x / y的浮点余数。
如果发生域错误，则返回实现定义的值（NaN，如果支持）。
如果由于下溢而发生范围错误，则返回正确的结果（舍入后）。
错误处理
按照math_errhandling中的指定报告错误。
如果y为零，则可能会出现域错误。
如果实现支持IEEE浮点运算（IEC 60559），
- 如果x为±0且y不为零，则返回±0
注意
如果x是无限的或者y是零，POSIX要求发生域错误。
fmod，但不是余数对于将浮点类型静默包装为无符号整数类型非常有用：（0.0 <=（y = fmod（rint（x），65536.0））？y：65536.0 + y）在范围[ -0.0 .. 65535.0]，它对应于无符号短整数，但余数（rint（x），65536.0在[-32767.0，+ 32768.0]的范围内，它在有符号短整数范围之外。
fmod的双重版本的行为如同执行如下：
double fmod(double x, double y)
{
#pragma STDC FENV_ACCESS ON
double result = remainder(fabs(x), (y = fabs(y))
if (signbit(result)) result += y;
return copysign(result, x
}
例
#include <stdio.h>
#include <math.h>
#include <fenv.h>
#pragma STDC FENV_ACCESS ON
int main(void)
{
printf("fmod(+5.1, +3.0) = %.1f\n", fmod(5.1,3)
printf("fmod(-5.1, +3.0) = %.1f\n", fmod(-5.1,3)
printf("fmod(+5.1, -3.0) = %.1f\n", fmod(5.1,-3)
printf("fmod(-5.1, -3.0) = %.1f\n", fmod(-5.1,-3)
// special values
printf("fmod(+0.0, 1.0) = %.1f\n", fmod(0, 1)
printf("fmod(-0.0, 1.0) = %.1f\n", fmod(-0.0, 1)
printf("fmod(+5.1, Inf) = %.1f\n", fmod(5.1, INFINITY)
// error handling
feclearexcept(FE_ALL_EXCEPT
printf("fmod(+5.1, 0) = %.1f\n", fmod(5.1, 0)
if(fetestexcept(FE_INVALID)) puts(" FE_INVALID raised"
}
可能的输出：
fmod(+5.1, +3.0) = 2.1
fmod(-5.1, +3.0) = -2.1
fmod(+5.1, -3.0) = 2.1
fmod(-5.1, -3.0) = -2.1
fmod(+0.0, 1.0) = 0.0
fmod(-0.0, 1.0) = -0.0
fmod(+5.1, Inf) = 5.1
fmod(+5.1, 0) = nan
FE_INVALID raised
参考
- C11标准（ISO / IEC 9899：2011）：
扩展内容
| divldivlldiv（C99） | 计算整数除法（函数）的商和余数 |
|---|---|
| remainderremainderfremainderl (C99)(C99)(C99) | 计算浮点除法运算的有符号余数（函数） |
| remquoremquofremquol（C99）（C99）（C99） | 计算带符号的余数以及除法操作（函数）的最后三位 |
| fmod 的 C ++文档 |
