fmin, fminf, fminl

 

C

语言

头文件

类型支持

程序工具

变参数函数支持

动态内存管理

错误处理

日期和时间工具

字符串库

算法

数值

输入/输出支持

本地化支持

线程支持 (C11)

原子操作 (C11)

技术规范

 

数值

常用数学函数

浮点环境

复数算术

伪随机数生成

泛型数学

 

常用数学函数

函数
基本运算
abslabsllabsimaxabs (C99) fabs divldivlldivimaxdiv (C99) fmod	remainder (C99) remquo (C99) fma (C99) fmax (C99) fmin (C99) fdim (C99) nannanfnanl (C99)(C99)(C99)
指数函数
exp exp2 (C99) expm1 (C99)	log log10 log1p (C99) log2 (C99)
幂函数
sqrt cbrt (C99)	hypot (C99) pow
三角及双曲函数
sin cos tan asin acos atan atan2	sinh cosh tanh asinh (C99) acosh (C99) atanh (C99)
误差及伽马函数
erf (C99) erfc (C99)	lgamma (C99) tgamma (C99)
临近整数的浮点运算
ceil floor roundlroundllround (C99)(C99)(C99)	trunc (C99) nearbyint (C99) rintlrintllrint (C99)(C99)(C99)
浮点数操作函数
ldexp scalbnscalbln (C99)(C99) ilogb (C99) logb (C99)	frexp modf nextafternexttoward (C99)(C99) copysign (C99)
分类
fpclassify (C99) isfinite (C99) isinf (C99) isnan (C99) isnormal (C99) signbit (C99)	isgreater (C99) isgreaterequal (C99) isless (C99) islessequal (C99) islessgreater (C99) isunordered (C99)
类型
div_tldiv_tlldiv_timaxdiv_t (C99)(C99)	float_tdouble_t (C99)(C99)
宏常量
HUGE_VALFHUGE_VALHUGE_VALL (C99)(C99) FP_FAST_FMAFFP_FAST_FMAFP_FAST_FMAL (C99)(C99)(C99) math_errhandlingMATH_ERRNOMATH_ERRNOEXCEPT (C99)(C99)(C99)	INFINITY (C99) NAN (C99) FP_ILOGB0FP_ILOGBNAN (C99)(C99) FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C99)(C99)(C99)(C99)(C99)

 

定义于头文件 <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 <stdio.h>
#include <math.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

引用

• C11 standard (ISO/IEC 9899:2011):

• 7.12.12.3 The fmin functions (p: 258)

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

• F.10.9.3 The fmin functions (p: 530)

• C99 standard (ISO/IEC 9899:1999):

• 7.12.12.3 The fmin functions (p: 239)

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

• F.9.9.3 The fmin functions (p: 466)

参阅

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