std::fmin，std::fminf，std::fminl

定义在头文件 `<cmath>` 中
	(1)
float fmin ( float x, float y ); double fmin ( double x, double y ); long double fmin ( long double x, long double y );			(直到 C++23)
constexpr /* 浮点类型 / fmin ( / 浮点类型 / x, / 浮点类型 */ y );			(自 C++23 起)
float fminf( float x, float y );		(2)	(自 C++11 起) (自 C++23 起为 constexpr)
long double fminl( long double x, long double y );		(3)	(自 C++11 起) (自 C++23 起为 constexpr)
附加重载 (自 C++11 起)
定义在头文件 `<cmath>` 中
template< class Integer > double fmin ( Integer x, Integer y );		(A)	(自 C++23 起为 constexpr)

1-3) 返回两个浮点参数中较小的一个，将 NaN 视为缺失数据（在 NaN 和数值之间，选择数值）。库为所有 cv 无限定浮点类型提供了 std::fmin 的重载，作为参数的类型。(自 C++23 起)

A) 为所有整数类型提供附加重载，这些类型被视为 double.

(自 C++11 起)

[编辑] 参数

x, y

-

浮点值或整数值

[编辑] 返回值

如果成功，则返回两个浮点值中较小的一个。返回的值是精确的，不依赖于任何舍入模式。

[编辑] 错误处理

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

如果实现支持 IEEE 浮点运算 (IEC 60559)，

如果两个参数之一是 NaN，则返回另一个参数的值。
只有当两个参数都是 NaN 时，才会返回 NaN。

[编辑] 说明

此函数不需要对零的符号敏感，尽管一些实现额外强制执行，如果一个参数是 +0 另一个是 -0，则返回 -0。

附加重载不需要完全按照 (A) 提供。它们只需要足以确保对于它们的第一个参数 num1 和第二个参数 num2

如果 num1 或 num2 的类型是 long double，则 std::fmin(num1, num2) 与 std::fmin(static_cast<long double>(num1),
static_cast<long double>(num2)) 的效果相同。
否则，如果 num1 和/或 num2 的类型为 double 或整数类型，则 std::fmin(num1, num2) 的效果与 std::fmin(static_cast<double>(num1),
static_cast<double>(num2)) 相同。
否则，如果 num1 或 num2 的类型为 float，则 std::fmin(num1, num2) 的效果与 std::fmin(static_cast<float>(num1),
static_cast<float>(num2)) 相同。

(直到 C++23)

如果 num1 和 num2 具有算术类型，则 std::fmin(num1, num2) 的效果与 std::fmin(static_cast</* common-floating-point-type */>(num1),
static_cast</* common-floating-point-type */>(num2)) 相同，其中 /* common-floating-point-type */ 是具有 num1 和 num2 类型之间最高浮点转换等级和最高浮点转换次级等级的浮点类型，整数类型的参数被认为与 double 具有相同的浮点转换等级。

如果没有具有最高等级和次级等级的浮点类型，则重载解析不会从提供的重载中得到可用的候选者。

(自 C++23 起)

[edit] 示例

运行此代码

#include <cmath>
#include <iostream>
 
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

[edit] 另请参阅

isless (C++11)	检查第一个浮点参数是否小于第二个参数 (function) [edit]
fmaxfmaxffmaxl (C++11)(C++11)(C++11)	两个浮点值中较大的值 (function) [edit]
min	返回给定值中较小的值 (function template) [edit]
min_element	返回范围内最小的元素 (function template) [edit]
minmax (C++11)	返回两个元素中较小的和较大的值 (function template) [edit]
minmax_element (C++11)	返回范围内最小的和最大的元素 (function template) [edit]
C 文档 for fmin

编译器支持
独立和托管
语言
标准库
标准库头文件
命名需求
特性测试宏 (C++20)
语言支持库
概念库 (C++20)
元编程库 (C++11)
诊断库
通用实用程序库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
并发支持库 (C++11)
执行支持库 (C++26)
技术规范
符号索引
外部库

cppreference.com

命名空间

变体

视图

操作