C++ 名前付き要件: Predicate

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

C++ 名前付き要件

基本 DefaultConstructible MoveConstructible (C++11) CopyConstructible CopyAssignable MoveAssignable (C++11) Destructible 型のプロパティ ScalarType PODType TriviallyCopyable (C++11) TrivialType (C++11) StandardLayoutType (C++11)   ImplicitLifetimeType ライブラリワイド BooleanTestable EqualityComparable LessThanComparable Swappable ValueSwappable (C++11) NullablePointer (C++11) Hash (C++11) アロケータ FunctionObject Callable Predicate BinaryPredicate Compare

コンテナ コンテナ ReversibleContainer AllocatorAwareContainer SequenceContainer ContiguousContainer (C++17) AssociativeContainer UnorderedAssociativeContainer (C++11)   コンテナ要素 DefaultInsertable (C++11) CopyInsertable (C++11) MoveInsertable (C++11) EmplaceConstructible (C++11) Erasable (C++11) イテレータ LegacyIterator LegacyInputIterator LegacyOutputIterator LegacyForwardIterator LegacyBidirectionalIterator LegacyRandomAccessIterator LegacyContiguousIterator (C++17) ConstexprIterator (C++20) ストリームI/O FormattedInputFunction UnformattedInputFunction FormattedOutputFunction UnformattedOutputFunction フォーマッタ BasicFormatter (C++20) フォーマッタ (C++20)

乱数 SeedSequence (C++11) RandomNumberEngine (C++11) RandomNumberDistribution (C++11) UniformRandomBitGenerator (C++11) RandomNumberEngineAdaptor (C++11) 並行性 BasicLockable (C++11) Lockable (C++11) TimedLockable (C++11) SharedLockable (C++14) SharedTimedLockable (C++14) Mutex (C++11) TimedMutex (C++11) SharedMutex (C++17) SharedTimedMutex (C++14) Ranges RangeAdaptorObject (C++20) RangeAdaptorClosureObject (C++20) 多次元ビュー LayoutMapping (C++23) LayoutMappingPolicy (C++23) AccessorPolicy (C++23) その他 CharTraits RegexTraits (C++11)   BitmaskType LiteralType (C++11) NumericType UnaryTypeTrait (C++11) BinaryTypeTrait (C++11) TransformationTrait (C++11) Clock (C++11) TrivialClock (C++11)

 

Predicate 要件は、BooleanTestable 値を返す呼び出し可能なものを記述します。

Predicate は通常、入力データ（個々のオブジェクト/コンテナ）と述語を受け取り、その述語がさらなる行動を決定するために入力データに対して呼び出されるアルゴリズムとともに使用されます。C++ 標準ライブラリにおける述語の使用例をいくつか示します。

• std::all_of、std::any_of、std::none_of は、要素の配列と述語を入力として取ります。個々の入力要素に対して述語を呼び出し、すべての/いずれかの/どの要素に対しても述語が true を返す場合は true を返します。

• std::find_if は、要素のシーケンスと述語を取ります。シーケンス内で、述語が true に等しい値を返す最初の要素を返します。

上記で示されたアルゴリズム機能の説明は、Predicate を簡単な言葉で説明することを意図した、粗いものです。詳細については、個々のページを参照してください。

言い換えると、アルゴリズムが Predicate pred とイテレータ first を取る場合、イテレータ first が指す型のオブジェクトを、if (pred(*first)) { /*...*/ } のような構文で、指定された述語を使用してテストできる必要があります。

関数オブジェクト pred は、デリファレンスされたイテレータを通して非 const 関数を適用してはならず、const 引数を受け入れる必要があり、引数が const であるか非-const であるかに関わらず同じ動作をします。この関数オブジェクトは、関数へのポインタ、または適切な関数呼び出し演算子を持つ型のオブジェクトである可能性があります。

要件

• FunctionObject

不具合報告

以下の動作変更を伴う欠陥報告が、以前に公開されたC++標準に遡って適用されました。

DR	適用対象	公開された動作	正しい動作
LWG 3031	C++98	const 値に対する要件が不十分でした。	要件が強化された

関連項目

predicate (C++20)

呼び出し可能型が真偽値を返す述語 (Boolean predicate) であることを規定する (コンセプト)