fmin, fminf, fminl

< c‎ | numeric‎ | math
在标头 <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 页）

参阅

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