std::min

来自cppreference.com
< cpp‎ | algorithm

 
 
算法库
执行策略 (C++17)
不修改的序列操作
(C++11)
(C++11)
(C++11)
(C++17)
修改的序列操作
未初始化存储上的操作
划分操作
排序操作
(C++11)
二分查找操作
集合操作(在已排序范围上)
堆操作
(C++11)
最小/最大操作
(C++11)
(C++17)

重排
数值操作
C 库
 
定义于头文件 <algorithm>
template< class T >
const T& min( const T& a, const T& b );
(1)
template< class T, class Compare >
const T& min( const T& a, const T& b, Compare comp );
(2)
template< class T >
T min( std::initializer_list<T> ilist);
(3) (C++11 起)
template< class T, class Compare >
T min( std::initializer_list<T> ilist, Compare comp );
(4) (C++11 起)
1-2)
返回两个值中的较小者的.
原文:
Returns the smaller of the two values.
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
3-4)
返回最小的值初始化列表中的ilist.
原文:
Returns the smallest of the values in initializer list ilist.
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
(1,3)版本使用operator<的值进行比较,(2,4)版本使用给定的比较函数comp
原文:
The (1,3) versions use operator< to compare the values, the (2,4) versions use the given comparison function comp.
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

目录

[编辑] 参数

a, b -
值进行比较
原文:
the values to compare
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
ilist -
初始化列表中的值进行比较
原文:
initializer list with the values to compare
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
cmp - 比较函数对象(即满足比较Compare)要求的对象),若 if a is less than b,则返回 ​true

比较函数的签名应等价于如下者:

 bool cmp(const Type1 &a, const Type2 &b);

签名不需要拥有 const & ,但函数对象必须不修改传递给它的对象。
类型 Type1Type2 必须使得 T 类型的对象能隐式转换到这两个类型。 ​

类型要求
-
T 必须满足 LessThanComparable 的要求。for the overloads (1) and (3)
-
T 必须满足 CopyConstructible 的要求。for the overloads (3) and (4)

[编辑] 返回值

1-2)
较小的ab。如果这两个值是相等的,返回a.
原文:
The smaller of a and b. If the values are equivalent, returns a.
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
3-4)
ilist中的最小值。如果有多个值相当于最小,最左边的值返回.
原文:
The smallest value in ilist. If several values are equivalent to the smallest, returns the leftmost such value.
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

[编辑] 复杂度

1-2)
常数
原文:
Constant
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
3-4)
线性ilist.size()
原文:
Linear in ilist.size()
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

[编辑] 可能的实现

版本一
template<class T> 
const T& min(const T& a, const T& b)
{
    return (a < b) ? a : b;
}
版本二
template<class T, class Compare> 
const T& min(const T& a, const T& b, Compare comp)
{
    return (comp(a, b)) ? a : b;
}
版本三
template<class T>
T min( std::initializer_list<T> ilist)
{
    return *std::min_element(ilist.begin(), ilist.end());
}
版本四
template<class T, class Compare>
T min(std::initializer_list<T> ilist, Compare comp)
{
    return *std::min_element(ilist.begin(), ilist.end(), comp);
}

[编辑] 示例

#include <algorithm>
#include <iostream>
 
int main()
{
    std::cout << "smaller of 1 and 9999: " << std::min(1, 9999) << '\n';
    std::cout << "smaller of 'a' and 'b': " << std::min('a', 'b') << '\n';
    std::cout << "smaller of 3.5 and 2.5: " << std::min(3.5, 2.5) << '\n';
}

输出:

smaller of 1 and 9999: 1
smaller of 'a' and 'b': a
smaller of 3.5 and 2.5: 2.5

[编辑] 另请参阅

返回两个元素中的较大者
(函数模板) [编辑]
(C++11)
返回两个元素中的的较大者和较小者
(函数模板) [编辑]
返回区间内的最小元素
(函数模板) [编辑]