fmin, fminf, fminl

来自cppreference.com
< c‎ | numeric‎ | math
 
 
 
常用数学函数
函数
基本运算
(C99)
(C99)
(C99)
(C99)(C99)(C99)(C23)
最大/最小运算
fmin
(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)
(C99)
(C99)(C99)(C99)
(C23)(C23)(C23)(C23)
浮点操作函数
(C99)(C99)
(C99)(C23)
(C99)
窄化运算
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
量与量指数函数
十进制重编码函数
全序与载荷函数
分类
(C99)
(C99)
(C99)
(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 <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 标准(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)
确定两个浮点值的较大者
(函数)