std::is_partitioned

ヘッダー `<algorithm>` で定義
template< class InputIt, class UnaryPred > bool is_partitioned( InputIt first, InputIt last, UnaryPred p );	(1)	(C++11以降) (C++20 以降 constexpr)
template< class ExecutionPolicy, class ForwardIt, class UnaryPred > bool is_partitioned( ExecutionPolicy&& policy, ForwardIt first, ForwardIt last, UnaryPred p );	(2)	(C++17以降)

1) [first, last) が述語 p によって分割されているかチェックします。つまり、p を満たす全ての要素が満たさない全ての要素より前に出現するかどうかです。

2) (1) と同じですが、policy に従って実行されます。

このオーバーロードは、以下のすべての条件が満たされた場合にのみオーバーロード解決に参加します。

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	-	使用する実行ポリシー
p	-	範囲の先頭に見つかることを期待される要素に対してtrueを返す単項述語。 p(v) という式は、(おそらくconstな) `VT` 型の全ての引数 `v` に対して bool に変換可能でなければなりません。ここで `VT` は `InputIt` の値型であり、値カテゴリに関わらず、`v` を変更してはなりません。したがって、VT& のパラメータ型は許可されません。また、`VT` の移動がコピーと同等でない限り、VT も許可されません(C++11以降)。
型要件
- `InputIt` は LegacyInputIterator の要件を満たす必要があります。
- `ForwardIt` は LegacyForwardIterator の要件を満たし、その値型は `UnaryPred` のパラメータ型に変換可能でなければなりません。
- `UnaryPred` は Predicate の要件を満たさなければなりません。

[編集] 戻り値

[first, last) の要素 e が式 p(e) に関して分割されている場合、true。そうでない場合、false。

[編集] 計算量

p の適用回数は最大で std::distance(first, last)。

[編集] 例外

テンプレートパラメータ ExecutionPolicy を持つオーバーロードは、次のようにエラーを報告します。

アルゴリズムの一部として呼び出された関数の実行が例外をスローし、ExecutionPolicy が標準ポリシーのいずれかである場合、std::terminate が呼び出されます。その他の ExecutionPolicy の場合、動作は実装定義です。
アルゴリズムがメモリの割り当てに失敗した場合、std::bad_alloc がスローされます。

[編集] 可能な実装

template<class InputIt, class UnaryPred>
bool is_partitioned(InputIt first, InputIt last, UnaryPred p)
{
    for (; first != last; ++first)
        if (!p(*first))
            break;
    for (; first != last; ++first)
        if (p(*first))
            return false;
    return true;
}

[編集] 例

このコードを実行

#include <algorithm>
#include <array>
#include <iostream>
 
int main()
{
    std::array<int, 9> v {1, 2, 3, 4, 5, 6, 7, 8, 9};
 
    auto is_even = [](int i) { return i % 2 == 0; };
    std::cout.setf(std::ios_base::boolalpha);
    std::cout << std::is_partitioned(v.begin(), v.end(), is_even) << ' ';
 
    std::partition(v.begin(), v.end(), is_even);
    std::cout << std::is_partitioned(v.begin(), v.end(), is_even) << ' ';
 
    std::reverse(v.begin(), v.end());
    std::cout << std::is_partitioned(v.cbegin(), v.cend(), is_even) << ' ';
    std::cout << std::is_partitioned(v.crbegin(), v.crend(), is_even) << '\n';
}

出力

false true false true

[編集] 関連項目

partition	要素の範囲を2つのグループに分割する (関数テンプレート) [編集]
partition_point (C++11)	パーティション化された範囲のパーティションポイントを見つける (関数テンプレート) [編集]
ranges::is_partitioned (C++20)	範囲が指定された述語によってパーティション化されているかどうかを判断する (アルゴリズム関数オブジェクト)[編集]

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

cppreference.com

名前空間

変種

表示

操作