C++ 参考手册

位置：首页 > C++ 参考手册 >数值库 >常用数学函数 > std::fmin, std::fminf, std::fminl

std::fmin, std::fminf, std::fminl

定义于头文件 <cmath>
float       fmin ( float x, float y );
float       fminf( float x, float y );
 (1) (C++11 起)
double      fmin ( double x, double y );
 (2) (C++11 起)
long double fmin ( long double x, long double y );
long double fminl( long double x, long double y );
 (3) (C++11 起)
Promoted    fmin ( Arithmetic x, Arithmetic y );
 (4) (C++11 起)
1-3) 返回二个浮点数的较小者，把 NaNs 当做缺失数据（在 NaN 和数值间选择数值）
4) 所有 1-3) 所不覆盖的算术类型参数组合的重载集或函数模板。若任何参数拥有整数类型，则将它转型为 double 。若任何其他参数为 long double ，则返回类型为 long double ，否则为 double 。

参数

x, y - 浮点或整数类型值

返回值

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

错误处理

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

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

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

注意

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

示例

运行此代码
#include <iostream>
#include <cmath>
 
int main()
{
    std::cout << "fmin(2,1)    = " << std::fmin(2,1) << '\n'
              << "fmin(-Inf,0) = " << std::fmin(-INFINITY,0) << '\n'
              << "fmin(NaN,-1) = " << std::fmin(NAN,-1) << '\n';
}

可能的输出： 

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

参阅

(C++11)
 检查第一个浮点实参是否小于第二个
(函数)
(C++11)(C++11)(C++11)
 两个浮点值的较大者
(函数)
返回各给定值中的较小者
(函数模板)
返回范围内的最小元素
(函数模板)
(C++11)
 返回两个元素的较小和较大者
(函数模板)
(C++11)
 返回范围内的最小元素和最大元素
(函数模板)