std:: inplace_merge
|
定義先ヘッダ
<algorithm>
|
||
|
template
<
class
BidirIt
>
void inplace_merge ( BidirIt first, BidirIt middle, BidirIt last ) ; |
(1) | (constexpr since C++26) |
|
template
<
class
ExecutionPolicy,
class
BidirIt
>
void
inplace_merge
(
ExecutionPolicy
&&
policy,
|
(2) | (since C++17) |
|
template
<
class
BidirIt,
class
Compare
>
void
inplace_merge
(
BidirIt first, BidirIt middle, BidirIt last,
|
(3) | (constexpr since C++26) |
|
template
<
class
ExecutionPolicy,
class
BidirIt,
class
Compare
>
void
inplace_merge
(
ExecutionPolicy
&&
policy,
|
(4) | (since C++17) |
2つの連続したソート済み範囲
[
first
,
middle
)
と
[
middle
,
last
)
を1つのソート済み範囲
[
first
,
last
)
にマージします。
[
first
,
middle
)
または
middle
と
last
の間の範囲
[
middle
,
last
)
が
comp
に関してソートされていない場合、動作は未定義です。
|
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以降) |
このマージ関数は安定しています。つまり、元の2つの範囲で等価な要素の場合、最初の範囲の要素(元の順序を保持)が2番目の範囲の要素(元の順序を保持)よりも前に配置されます。
以下のいずれかの条件が満たされる場合、動作は未定義です:
-
[first,middle)または[middle,last)が 有効な範囲 ではありません。
|
(C++11以前) |
|
(C++11以降) |
目次 |
パラメータ
| first | - | 最初のソート済み範囲の先頭 |
| middle | - | 最初のソート済み範囲の終端と2番目の範囲の先頭 |
| last | - | 2番目のソート済み範囲の終端 |
| policy | - | 使用する 実行ポリシー |
| comp | - |
比較関数オブジェクト(つまり
Compare
要件を満たすオブジェクト)。最初の引数が2番目の引数より
小さい
(つまり
前に順序付けられる
)場合に
true
を返す。
比較関数のシグネチャは以下と同等であるべき: bool cmp ( const Type1 & a, const Type2 & b ) ;
シグネチャが
const
&
を持つ必要はないが、関数は渡されたオブジェクトを変更してはならず、
値カテゴリ
に関係なく型(おそらくconst)
|
| 型要件 | ||
-
BidirIt
は
LegacyBidirectionalIterator
の要件を満たさなければならない。
|
||
-
Compare
は
Compare
の要件を満たさなければならない。
|
||
計算量
与えられた N を std:: distance ( first, last ) として:
例外
ExecutionPolicy
という名前のテンプレートパラメータを持つオーバーロードは、
以下のようにエラーを報告します:
-
アルゴリズムの一部として呼び出された関数の実行が例外をスローした場合、
ExecutionPolicyが 標準ポリシー のいずれかであるとき、 std::terminate が呼び出されます。それ以外のExecutionPolicyについては、動作は実装定義です。 - アルゴリズムがメモリの確保に失敗した場合、 std::bad_alloc がスローされます。
実装例
実装は libstdc++ および libc++ でご確認ください。
注記
この関数は一時バッファの割り当てを試みます。割り当てに失敗した場合、効率の低いアルゴリズムが選択されます。
| 機能テスト マクロ | 値 | 標準 | 機能 |
|---|---|---|---|
__cpp_lib_constexpr_algorithms
|
202306L
|
(C++26) | constexpr インプレースマージ ( 1 ) , ( 3 ) |
例
以下のコードはマージソートの実装です。
#include <algorithm> #include <iostream> #include <vector> template<class Iter> void merge_sort(Iter first, Iter last) { if (last - first > 1) { Iter middle = first + (last - first) / 2; merge_sort(first, middle); merge_sort(middle, last); std::inplace_merge(first, middle, last); } } int main() { std::vector<int> v{8, 2, -2, 0, 11, 11, 1, 7, 3}; merge_sort(v.begin(), v.end()); for (const auto& n : v) std::cout << n << ' '; std::cout << '\n'; }
出力:
-2 0 1 2 3 7 8 11 11
関連項目
|
二つのソート済み範囲をマージする
(関数テンプレート) |
|
|
範囲を昇順にソートする
(関数テンプレート) |
|
|
等価な要素間の順序を保ちながら範囲をソートする
(関数テンプレート) |
|
|
(C++20)
|
二つの順序付けられた範囲をその場でマージする
(アルゴリズム関数オブジェクト) |