std:: minmax_element
|
定义于头文件
<algorithm>
|
||
|
template
<
class
ForwardIt
>
std::
pair
<
ForwardIt, ForwardIt
>
|
(1) |
(C++11 起)
(C++17 起为 constexpr) |
|
template
<
class
ExecutionPolicy,
class
ForwardIt
>
std::
pair
<
ForwardIt, ForwardIt
>
|
(2) | (C++17 起) |
|
template
<
class
ForwardIt,
class
Compare
>
std::
pair
<
ForwardIt, ForwardIt
>
|
(3) |
(C++11 起)
(C++17 起为 constexpr) |
|
template
<
class
ExecutionPolicy,
class
ForwardIt,
class
Compare
>
std::
pair
<
ForwardIt, ForwardIt
>
|
(4) | (C++17 起) |
查找范围
[
first
,
last
)
中的最小与最大元素。
|
std:: is_execution_policy_v < std:: decay_t < ExecutionPolicy >> 为 true 。 |
(C++20 前) |
|
std:: is_execution_policy_v < std:: remove_cvref_t < ExecutionPolicy >> 为 true 。 |
(C++20 起) |
目录 |
参数
| first, last | - | 定义待检验元素范围的迭代器对 |
| policy | - | 要使用的执行策略 |
| cmp | - |
比较函数对象(即满足比较要求),若第一参数小于第二参数则返回
true
。
比较函数的签名应等价于如下形式: bool cmp ( const Type1 & a, const Type2 & b ) ;
虽然签名不需要包含
const
&
,但函数不得修改传递的对象,且必须能够接受所有(可能为 const 的)
|
| 类型要求 | ||
-
ForwardIt
必须满足
向前迭代器
的要求。
|
||
返回值
一个以指向最小元素的迭代器作为第一个元素,指向最大元素的迭代器作为第二个元素的配对。若范围为空则返回 std:: make_pair ( first, first ) 。若有多个元素等价于最小元素,则返回指向首个此类元素的迭代器。若有多个元素等价于最大元素,则返回指向最后一个此类元素的迭代器。
复杂度
给定 N 为 std:: distance ( first, last ) :
| 3 |
| 2 |
异常
带有名为
ExecutionPolicy
模板参数的重载按以下方式报告错误:
-
如果作为算法一部分调用的函数执行抛出异常,且
ExecutionPolicy是某个 标准策略 ,则调用 std::terminate 。对于其他任何ExecutionPolicy,其行为由实现定义。 - 如果算法无法分配内存,则抛出 std::bad_alloc 。
可能的实现
| minmax_element |
|---|
template<class ForwardIt> std::pair<ForwardIt, ForwardIt> minmax_element(ForwardIt first, ForwardIt last) { using value_type = typename std::iterator_traits<ForwardIt>::value_type; return std::minmax_element(first, last, std::less<value_type>()); } |
| minmax_element |
template<class ForwardIt, class Compare> std::pair<ForwardIt, ForwardIt> minmax_element(ForwardIt first, ForwardIt last, Compare comp) { auto min = first, max = first; if (first == last || ++first == last) return {min, max}; if (comp(*first, *min)) min = first; else max = first; while (++first != last) { auto i = first; if (++first == last) { if (comp(*i, *min)) min = i; else if (!(comp(*i, *max))) max = i; break; } else { if (comp(*first, *i)) { if (comp(*first, *min)) min = first; if (!(comp(*i, *max))) max = i; } else { if (comp(*i, *min)) min = i; if (!(comp(*first, *max))) max = first; } } } return {min, max}; } |
注释
该算法与 std:: make_pair ( std:: min_element ( ) , std:: max_element ( ) ) 不同,不仅体现在效率上,还在于本算法会找到 最后一个 最大元素,而 std::max_element 会找到 第一个 最大元素。
示例
#include <algorithm> #include <iostream> int main() { const auto v = {3, 9, 1, 4, 2, 5, 9}; const auto [min, max] = std::minmax_element(begin(v), end(v)); std::cout << "min = " << *min << ", max = " << *max << '\n'; }
输出:
min = 1, max = 9
参见
|
返回范围内的最小元素
(函数模板) |
|
|
返回范围内的最大元素
(函数模板) |
|
|
(C++20)
|
返回范围内的最小和最大元素
(算法函数对象) |