命名空间
变体
操作

fdim、fdimf、fdiml

来自 cppreference.com
< c‎ | numeric‎ | math
 
 
 
常用数学函数
类型
(C99)(C99)    

(C99)(C99)    

函数
基本操作
(C99)
(C99)
fdim
(C99)
(C99)(C99)(C99)(C23)
最大值/最小值操作
(C99)
(C23)    
指数函数
(C23)
(C99)
(C99)
(C23)
(C23)
(C99)
(C99)(C23)
(C23)
(C23)
幂函数
(C99)
(C23)
(C23)
(C99)
(C23)
(C23)
三角函数和双曲函数
(C23)
(C23)
(C23)
(C23)
(C99)
(C99)
(C99)
误差函数和伽马函数
(C99)
(C99)
(C99)
(C99)
最近整数浮点运算
(C99)(C99)(C99)
(C99)
(C99)(C99)(C99)
(C23)(C23)(C23)(C23)
浮点运算操作函数
(C99)(C99)
(C99)(C23)
(C99)
缩窄操作
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
量子和量子指数函数
十进制重新编码函数
全序和有效载荷函数
分类
(C99)
(C99)
(C99)
(C23)
宏常量
特殊浮点值
(C99)(C23)
参数和返回值
(C99)(C99)(C99)(C99)(C99)    
错误处理
(C99)    

 
定义在头文件 <math.h>
float       fdimf( float x, float y );
(1) (自 C99)
double      fdim( double x, double y );
(2) (自 C99)
long double fdiml( long double x, long double y );
(3) (自 C99)
定义在头文件 <tgmath.h>
#define fdim( x, y )
(4) (自 C99)
1-3) 返回 xy 之间的正差,也就是说,如果 x>y,则返回 x-y,否则(如果 x≤y),则返回 +0。
4) 类型泛型宏:如果任何参数具有类型 long double,则调用 fdiml。否则,如果任何参数具有整型或类型 double,则调用 fdim。否则,调用 fdimf

内容

[编辑] 参数

x, y - 浮点值

[编辑] 返回值

如果成功,则返回 xy 之间的正差。

如果由于溢出而发生范围错误,则返回 +HUGE_VAL+HUGE_VALF+HUGE_VALL

如果由于下溢而发生范围错误,则返回正确的值(四舍五入后)。

[编辑] 错误处理

错误报告如 模板:rllpt 中所述。

如果实现支持 IEEE 浮点运算(IEC 60559),则

  • 如果任一参数为 NaN,则返回 NaN。

[编辑] 备注

等效于 fmax(x-y, 0),但 NaN 处理要求不同。

[编辑] 示例

#include <errno.h>
#include <fenv.h>
#include <math.h>
#include <stdio.h>
// #pragma STDC FENV_ACCESS ON
 
int main(void)
{
    printf("fdim(4, 1) = %f, fdim(1, 4)=%f\n", fdim(4,1), fdim(1,4));
    printf("fdim(4,-1) = %f, fdim(1,-4)=%f\n", fdim(4,-1), fdim(1,-4));
    //error handling
    errno = 0; feclearexcept(FE_ALL_EXCEPT);
    printf("fdim(1e308, -1e308) = %f\n", fdim(1e308, -1e308));
    if (errno == ERANGE)
        perror("    errno == ERANGE");
    if (fetestexcept(FE_OVERFLOW))
        puts("    FE_OVERFLOW raised");
}

可能的输出

fdim(4, 1) = 3.000000, fdim(1, 4)=0.000000
fdim(4,-1) = 5.000000, fdim(1,-4)=5.000000
fdim(1e308, -1e308) = inf
    errno == ERANGE: Numerical result out of range
    FE_OVERFLOW raised

[编辑] 参考资料

  • C23 标准(ISO/IEC 9899:2024)
  • 7.12.12.1 fdim 函数(p: TBD)
  • 7.25 类型泛型数学 <tgmath.h>(p: TBD)
  • F.10.9.1 fdim 函数(p: TBD)
  • C17 标准(ISO/IEC 9899:2018)
  • 7.12.12.1 fdim 函数(p: 187-188)
  • 7.25 类型泛型数学 <tgmath.h>(p: 272-273)
  • F.10.9.1 fdim 函数(p: 386)
  • C11 标准(ISO/IEC 9899:2011)
  • 7.12.12.1 fdim 函数(p: 257)
  • 7.25 类型泛型数学 <tgmath.h>(p: 373-375)
  • F.10.9.1 fdim 函数(p: 530)
  • C99 标准(ISO/IEC 9899:1999)
  • 7.12.12.1 fdim 函数(p: 238)
  • 7.22 类型泛型数学 <tgmath.h>(p: 335-337)
  • F.9.9.1 fdim 函数(p: 466)

[编辑] 另请参见

计算整数值的绝对值 (|x|)
(函数) [编辑]
(C99)(C99)(C99)
确定两个浮点值中较大的一个
(函数) [编辑]
C++ 文档 for fdim