命名空间
变体
操作

fdim, fdimf, fdiml

来自 cppreference.cn
< c‎ | 数值‎ | 数学
 
 
 
常用数学函数
函数
基本操作
(C99)
(C99)
fdim
(C99)
(C99)(C99)(C99)(C23)
最大值/最小值操作
(C99)
(C99)
指数函数
(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)
(C23)(C23)(C23)(C23)
浮点数操作
(C99)(C99)
(C99)(C23)
(C99)
窄化操作
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
量子与量子指数
十进制重新编码函数
总序和载荷函数
分类
(C99)
(C99)
(C99)
(C23)
误差函数和伽马函数
(C99)
(C99)
(C99)
(C99)
类型
宏常量
特殊浮点值
(C99)(C23)
参数和返回值
错误处理
快速操作指示符
 
定义于头文件 <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

如果发生下溢导致的范围错误,返回正确的值(舍入后)。

[编辑] 错误处理

错误按照 Template: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++ 文档 用于 fdim