fmin, fminf, fminl

 

C

编译器支持

语言

头文件

类型支持

程序工具

变参数函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

数值

常用数学函数

浮点环境 (C99)

伪随机数生成

复数算术 (C99)

泛型数学函数 (C99)

 

常用数学函数

类型
div_tldiv_tlldiv_timaxdiv_t (C99)(C99)     float_tdouble_t (C99)(C99)     _Decimal32_t_Decimal64_t (C23)(C23)
函数
基本运算 abslabsllabsimaxabs (C99)(C99) fabs divldivlldivimaxdiv (C99)(C99) fmod remainder (C99) remquo (C99) fma (C99) fdim (C99) nannanfnanlnandN (C99)(C99)(C99)(C23) 最大/最小运算 fmax (C99) fmaximum (C23) fmaximum_mag (C23) fmaximum_num (C23) fmaximum_mag_num (C23)     fmin (C99) fminimum (C23) fminimum_mag (C23) fminimum_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)	误差及伽马函数 erf (C99) erfc (C99) lgamma (C99) tgamma (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) samequantumdN (C23) quantumdN (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)
宏常量
特殊浮点值 HUGE_VALFHUGE_VALHUGE_VALLHUGE_VALDN (C99)(C99)(C23) INFINITYDEC_INFINITY (C99)(C23) NANDEC_NAN (C99)(C23) 参数与返回值 FP_ILOGB0FP_ILOGBNAN (C99)(C99) FP_INT_UPWARDFP_INT_DOWNWARDFP_INT_TOWARDZEROFP_INT_TONEARESTFROMZEROFP_INT_TONEAREST (C23)(C23)(C23)(C23)(C23)     FP_LLOGB0FP_LLOGBNAN (C23)(C23) FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C99)(C99)(C99)(C99)(C99)     错误处理 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       fminf( float x, float y );	(1)	(C99 起)
double      fmin( double x, double y );	(2)	(C99 起)
long double fminl( long double x, long double y );	(3)	(C99 起)
在标头 <tgmath.h> 定义
#define fmin( x, y )	(4)	(C99 起)

1-3) 返回二个浮点参数的较小者，把 NaNs 当做缺失数据（在 NaN 和数值间选择数值）。

4) 泛型宏：若任一实参拥有 long double 类型，则调用 fmaxl。否则，若任一实参拥有整数类型或 double 类型，则调用 fmax。否则调用 fmaxf 。

参数

x, y

-

浮点值

返回值

若成功，则返回两个浮点值的较小者。返回值准确且不依赖任何舍入模式。

错误处理

此函数不受制于任何指定于 math_errhandling 的错误条件。

若实现支持 IEEE 浮点算术（IEC 60559），则

• 若两个参数之一为 NaN，则返回另一实参的值
• 仅若两个参数均为 NaN，才返回 NaN

注解

不要求此函数对零的符号敏感，尽管某些实现额外强制若一个实参是 +0 而另一个是 -0，则返回 -0。

示例

运行此代码

#include <math.h>
#include <stdio.h>
 
int main(void)
{
    printf("fmin(2,1)    = %f\n", fmin(2, 1));
    printf("fmin(-Inf,0) = %f\n", fmin(-INFINITY, 0));
    printf("fmin(NaN,-1) = %f\n", fmin(NAN, -1));
}

可能的输出：

fmin(2,1)    = 1.000000
fmin(-Inf,0) = -inf
fmin(NaN,-1) = -1.000000

引用

• C23 标准（ISO/IEC 9899:2024）：

• 7.12.12.3 The fmin functions （第 TBD 页）

• 7.25 Type-generic math <tgmath.h> （第 TBD 页）

• F.10.9.3 The fmin functions （第 TBD 页）

• C17 标准（ISO/IEC 9899:2018）：

• 7.12.12.3 The fmin functions （第 TBD 页）

• 7.25 Type-generic math <tgmath.h> （第 TBD 页）

• F.10.9.3 The fmin functions （第 TBD 页）

• C11 标准（ISO/IEC 9899:2011）：

• 7.12.12.3 The fmin functions （第 258 页）

• 7.25 Type-generic math <tgmath.h> （第 373-375 页）

• F.10.9.3 The fmin functions （第 530 页）

• C99 标准（ISO/IEC 9899:1999）：

• 7.12.12.3 The fmin functions （第 239 页）

• 7.22 Type-generic math <tgmath.h> （第 335-337 页）

• F.9.9.3 The fmin functions （第 466 页）

参阅

isless (C99)	检查第一个浮点实参是否小于第二个 (宏函数)
fmaxfmaxffmaxl (C99)(C99)(C99)	确定两个浮点值的较大者 (函数)