fdim, fdimf, fdiml

 

C

编译器支持

语言

头文件

类型支持

程序实用工具

可变参数函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间实用工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

数值

常用数学函数

浮点环境 (C99)

伪随机数生成

复数算术 (C99)

类型泛型数学 (C99)

位操作 (C23)

Checked integer arithmetic (C23)

 

常用数学函数

函数 基本操作 abslabsllabsimaxabs (C99)(C99) fabs divldivlldivimaxdiv (C99)(C99) fmod remainder (C99) remquo (C99) fma (C99) fdim (C99) nannanfnanlnandN (C99)(C99)(C99)(C23) 最大/最小值操作 fmax (C99) fmin (C99) fmaximum (C23) fminimum (C23) fmaximum_mag (C23)  fmaximum_num (C23) fminimum_mag (C23) fminimum_num (C23) fmaximum_mag_num (C23) fminimum_mag_num (C23)   指数函数 exp exp10 (C23) exp2 (C99) expm1 (C99) exp10m1 (C23) exp2m1 (C23) log log10 log2 (C99) log1plogp1 (C99)(C23) log10p1 (C23) log2p1 (C23) 幂函数 sqrt cbrt (C99) rootn (C23) rsqrt (C23) hypot (C99) compound (C23) pow pown (C23) powr (C23) 三角函数和双曲函数 sin cos tan asin acos atan atan2 sinpi (C23) cospi (C23) tanpi (C23) asinpi (C23) acospi (C23) atanpi (C23) atan2pi (C23) sinh cosh tanh asinh (C99) acosh (C99) atanh (C99)

最近整数浮点 ceil floor roundlroundllround (C99)(C99)(C99) roundeven (C23) trunc (C99) nearbyint (C99) rintlrintllrint (C99)(C99)(C99) fromfpfromfpxufromfpufromfpx (C23)(C23)(C23)(C23) 浮点操作 ldexp frexp scalbnscalbln (C99)(C99) ilogbllogb (C99)(C23) logb (C99) modf nextafternexttoward (C99)(C99) nextupnextdown (C23)(C23) copysign (C99) canonicalize (C23) 窄化操作 fadd (C23) fsub (C23) fmul (C23) fdiv (C23) ffma (C23) fsqrt (C23) 量子和量子指数 quantizedN (C23) quantumdN (C23) samequantumdN (C23) llquantexpdN (C23) 十进制重编码函数 encodedecdN (C23) decodedecdN (C23) encodebindN (C23) decodebindN (C23) 总顺序和有效载荷函数 totalorder (C23) getpayload (C23) setpayload (C23) setpayloadsig (C23) 分类 fpclassify (C99) iscanonical (C23)  isfinite (C99) isinf (C99) isnan (C99) isnormal (C99) signbit (C99) issubnormal (C23) iszero (C23) isgreater (C99) isgreaterequal (C99)   isless (C99) islessequal (C99) islessgreater (C99) isunordered (C99) issignaling (C23) iseqsig (C23)

误差和伽玛函数 erf (C99) erfc (C99) lgamma (C99) tgamma (C99) 类型 div_tldiv_tlldiv_timaxdiv_t (C99)(C99) float_tdouble_t (C99)(C99) _Decimal32_t_Decimal64_t (C23)(C23) 宏常量 特殊浮点值 HUGE_VALHUGE_VALFHUGE_VALLHUGE_VALDN (C99)(C99)(C23) INFINITYDEC_INFINITY (C99)(C23) NANDEC_NAN (C99)(C23) 参数和返回值 FP_ILOGB0FP_ILOGBNAN (C99)(C99) FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C99)(C99)(C99)(C99)(C99) FP_LLOGB0FP_LLOGBNAN (C23)(C23) FP_INT_UPWARDFP_INT_DOWNWARDFP_INT_TOWARDZEROFP_INT_TONEARESTFROMZEROFP_INT_TONEAREST (C23)(C23)(C23)(C23)(C23) 错误处理 MATH_ERRNOMATH_ERRNOEXCEPT (C99)(C99)  math_errhandling (C99) 快速操作指示符 FP_FAST_FMAFFP_FAST_FMA (C99)(C99) FP_FAST_FADDFP_FAST_FADDLFP_FAST_DADDLFP_FAST_DMADDDN (C23)(C23)(C23)(C23) FP_FAST_FMULFP_FAST_FMULLFP_FAST_DMULLFP_FAST_DMMULDN (C23)(C23)(C23)(C23) FP_FAST_FFMAFP_FAST_FFMALFP_FAST_DFMALFP_FAST_DMFMADN (C23)(C23)(C23)(C23) FP_FAST_FMALFP_FAST_FMADN (C99)(C23) FP_FAST_FSUBFP_FAST_FSUBLFP_FAST_DSUBLFP_FAST_DMSUBDN (C23)(C23)(C23)(C23) FP_FAST_FDIVFP_FAST_FDIVLFP_FAST_DDIVLFP_FAST_DMDIVDN (C23)(C23)(C23)(C23) FP_FAST_FSQRTFP_FAST_FSQRTLFP_FAST_DSQRTLFP_FAST_DMSQRTDN (C23)(C23)(C23)(C23)

 

定义于头文件 <math.h>
float       fdimf( float x, float y );	(1)	(since C99)
double      fdim( double x, double y );	(2)	(since C99)
long double fdiml( long double x, long double y );	(3)	(since C99)
定义于头文件 <tgmath.h>
#define fdim( x, y )	(4)	(since C99)

1-3) 返回 x 和 y 之间的正差值，即，如果 x>y，返回 x-y，否则（如果 x≤y），返回 +0。

4) 类型泛型宏：如果任何参数具有类型 long double，则调用 fdiml。否则，如果任何参数具有整数类型或具有类型 double，则调用 fdim。否则，调用 fdimf。

参数

x, y

-

浮点值

返回值

如果成功，则返回 x 和 y 之间的正差值。

如果由于溢出而发生范围错误，则返回 +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 The fdim functions (p: TBD)

• 7.25 Type-generic math <tgmath.h> (p: TBD)

• F.10.9.1 The fdim functions (p: TBD)

• C17 标准 (ISO/IEC 9899:2018)

• 7.12.12.1 The fdim functions (p: 187-188)

• 7.25 Type-generic math <tgmath.h> (p: 272-273)

• F.10.9.1 The fdim functions (p: 386)

• C11 标准 (ISO/IEC 9899:2011)

• 7.12.12.1 The fdim functions (p: 257)

• 7.25 Type-generic math <tgmath.h> (p: 373-375)

• F.10.9.1 The fdim functions (p: 530)

• C99 标准 (ISO/IEC 9899:1999)

• 7.12.12.1 The fdim functions (p: 238)

• 7.22 Type-generic math <tgmath.h> (p: 335-337)

• F.9.9.1 The fdim functions (p: 466)

参见

abslabsllabs (C99)	计算整数值的绝对值 (\(\small{|x|}\)|x|) (函数)
fmaxfmaxffmaxl (C99)(C99)(C99)	确定两个浮点值中较大的值 (函数)
C++ 文档 for fdim