std::partition_point

ヘッダー `<algorithm>` で定義
template< class ForwardIt, class UnaryPred > ForwardIt partition_point( ForwardIt first, ForwardIt last, UnaryPred p );		(C++11以降) (C++20 以降 constexpr)

分割された範囲 [first, last) を調べ、最初のパーティションの終わり、つまり、p を満たさない最初の要素、またはすべての要素が p を満たす場合は last を見つけます。

[first, last) の要素 elem が式 bool(p(elem)) に関して分割されていない場合、動作は未定義です。

first, last	-	調査する要素の分割された範囲を定義するイテレータのペア
p	-	範囲の先頭に見つかった要素に対して true を返す単項述語。式 p(v) は、値カテゴリに関わらず、`ForwardIt` の値型である (const の可能性がある) `VT` 型のすべての引数 `v` に対して bool に変換可能でなければならず、`v` を変更してはなりません。したがって、VT& 型のパラメータは許可されません。また、`VT` の移動がコピーと同等でない限り VT も許可されません(C++11 以降)。
型要件
- `ForwardIt` は LegacyForwardIterator の要件を満たさなければなりません。
- `UnaryPred` は Predicate の要件を満たさなければなりません。

[編集] 戻り値

[first, last) 内の最初のパーティションの終わりの次のイテレータ、またはすべての要素が p を満たす場合は last。

[編集] 計算量

$\scriptsize N$ $N$ を std::distance(first, last) とすると、述語 p の適用回数は $\scriptsize O(log(N))$ $O(log(N))$ です。

[編集] 備考

このアルゴリズムは std::lower_bound のより一般的な形式であり、述語 [&](const auto& e) { return e < value; }); を用いて std::partition_point で表現できます。

[編集] 可能な実装

template<class ForwardIt, class UnaryPred>
constexpr //< since C++20
ForwardIt partition_point(ForwardIt first, ForwardIt last, UnaryPred p)
{
    for (auto length = std::distance(first, last); 0 < length; )
    {
        auto half = length / 2;
        auto middle = std::next(first, half);
        if (p(*middle))
        {
            first = std::next(middle);
            length -= (half + 1);
        }
        else
            length = half;
    }
 
    return first;
}

[編集] 例

このコードを実行

#include <algorithm>
#include <array>
#include <iostream>
#include <iterator>
 
auto print_seq = [](auto rem, auto first, auto last)
{
    for (std::cout << rem; first != last; std::cout << *first++ << ' ') {}
    std::cout << '\n';
};
 
int main()
{
    std::array v{1, 2, 3, 4, 5, 6, 7, 8, 9};
 
    auto is_even = [](int i) { return i % 2 == 0; };
 
    std::partition(v.begin(), v.end(), is_even);
    print_seq("After partitioning, v: ", v.cbegin(), v.cend());
 
    const auto pp = std::partition_point(v.cbegin(), v.cend(), is_even);
    const auto i = std::distance(v.cbegin(), pp);
    std::cout << "Partition point is at " << i << "; v[" << i << "] = " << *pp << '\n';
 
    print_seq("First partition (all even elements): ", v.cbegin(), pp);
    print_seq("Second partition (all odd elements): ", pp, v.cend());
}

実行結果の例

After partitioning, v: 8 2 6 4 5 3 7 1 9
Partition point is at 4; v[4] = 5
First partition (all even elements): 8 2 6 4
Second partition (all odd elements): 5 3 7 1 9

[編集] 関連項目

findfind_iffind_if_not (C++11)	特定の基準を満たす最初の要素を見つける (関数テンプレート) [編集]
is_sorted (C++11)	範囲が昇順にソートされているかどうかをチェックする (関数テンプレート) [編集]
lower_bound	与えられた値より小さくない最初の要素へのイテレータを返す (関数テンプレート) [編集]
ranges::partition_point (C++20)	パーティション化された範囲のパーティションポイントを見つける (アルゴリズム関数オブジェクト)[編集]

コンパイラサポート
フリースタンディングとホスト
言語
標準ライブラリ
標準ライブラリヘッダー
名前付き要件
機能テストマクロ (C++20)
言語サポートライブラリ
コンセプトライブラリ (C++20)
診断ライブラリ
メモリ管理ライブラリ
メタプログラミングライブラリ (C++11)
汎用ユーティリティライブラリ
コンテナライブラリ
イテレータライブラリ
Rangesライブラリ (C++20)
アルゴリズムライブラリ
文字列ライブラリ
テキスト処理ライブラリ
数値ライブラリ
日付と時刻ライブラリ
入出力ライブラリ
ファイルシステムライブラリ (C++17)
並行サポートライブラリ (C++11)
実行制御ライブラリ (C++26)
Technical specifications (技術仕様)
シンボルインデックス
外部ライブラリ

cppreference.com

名前空間

変種

表示

操作