std:: minmax_element
|
ヘッダー
<algorithm>
で定義
|
||
|
template
<
class
ForwardIt
>
std::
pair
<
ForwardIt, ForwardIt
>
|
(1) |
(C++11以降)
(constexpr C++17以降) |
|
template
<
class
ExecutionPolicy,
class
ForwardIt
>
std::
pair
<
ForwardIt, ForwardIt
>
|
(2) | (C++17以降) |
|
template
<
class
ForwardIt,
class
Compare
>
std::
pair
<
ForwardIt, ForwardIt
>
|
(3) |
(C++11以降)
(constexpr C++17以降) |
|
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 | - |
比較関数オブジェクト(つまり
Compare
要件を満たすオブジェクト)。最初の引数が2番目の引数より
小さい
場合に
true
を返す。
比較関数のシグネチャは以下と同等であるべき: bool cmp ( const Type1 & a, const Type2 & b ) ;
シグネチャが
const
&
を持つ必要はないが、関数は渡されたオブジェクトを変更してはならず、
値カテゴリ
に関係なく型(おそらくconst)
|
| 型要件 | ||
-
ForwardIt
は
LegacyForwardIterator
の要件を満たさなければならない。
|
||
戻り値
最小要素へのイテレータを第一要素、最大要素へのイテレータを第二要素とするペアを返す。範囲が空の場合、 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)
|
範囲内の最小要素と最大要素を返す
(アルゴリズム関数オブジェクト) |