fmodl (Numerics) – C 中文开发手册

??C 语言中文开发手册

fmodl (Numerics) - C 中文开发手册

1-3）计算除法运算x / y的浮点余数。4）类型 - 泛型宏：如果任何参数的类型为long double，则调用fmodl。 否则，如果任何参数具有整数类型或类型为double，则调用fmod。 否则，调用fmodf。由该函数计算的除法运算x / y的浮点余数正好是值x-n * y，其中n是x / y，其小数部分被截断。返回的值与x具有相同的符号，并且在幅度上小于或等于y。

参数

返回值

如果成功，返回如上定义的除法x / y的浮点余数。如果发生域错误，则返回实现定义的值（NaN，如果支持）。如果由于下溢而发生范围错误，则返回正确的结果（舍入后）。

错误处理

按照math_errhandling中的指定报告错误。如果y为零，则可能会出现域错误。如果实现支持IEEE浮点运算（IEC 60559），如果x为±0且y不为零，则返回±0如果x是±∞且y不是NaN，则返回NaN并引发FE_INVALID如果y为±0且x不是NaN，则返回NaN并引发FE_INVALID如果y是±∞且x是有限的，则返回x。如果任一参数是NaN，则返回NaN

注意

如果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）： 7.12.10.1 fmod函数（p：254） 7.25类型通用数学<tgmath.h>（p：373-375） F.10.7.1 fmod函数（p：528） C99标准（ISO / IEC 9899：1999）： 7.12.10.1 fmod函数（p：235） 7.22类型通用数学<tgmath.h>（p：335-337） F.9.7.1 fmod函数（p：465） C89 / C90标准（ISO / IEC 9899：1990）： 4.5.6.4 fmod函数

扩展内容

| fmod的C ++文档 |

??C 语言中文开发手册