C++ 名前付き要件: RangeAdaptorObject (C++20 以降)

 

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)

 

Range adaptor objects は、最初の引数として viewable_range を受け取り、view を返すカスタマイズポイントオブジェクトです。一部の range adaptor object は単項であり、つまり、1つの viewable_range を唯一の引数として取ります。その他の range adaptor object は、viewable_range とその他の後続の引数を取ります。

range adaptor object が1つの引数のみを取る場合、それは RangeAdaptorClosureObject でもあります。

range adaptor object が複数の引数を取る場合、それは部分適用もサポートします。以下のようにします。

• a がそのような range adaptor object であり、
• args... が引数（一般的には後続の引数に適したもの）である場合、

式 a(args...) は以下のプロパティを持ちます。

• これは、`args...` 内の各引数 e について、`E` が decltype((e)) であり、かつ std::is_constructible_v<std::decay_t<E>, E> が true である場合にのみ有効です。
• 呼び出しが有効な場合、その結果オブジェクトは、`args...` 内の各引数 e について、std::forward<E>(e) で直接（リスト初期化以外で）初期化された std::decay_t<E> 型のサブオブジェクトを格納します（つまり、range adaptor object は引数を値でバインドします）。
• 結果オブジェクトは RangeAdaptorClosureObject です。
• RangeAdaptorClosureObject の呼び出しは、バインドされた引数（存在する場合）を関連付けられた range adaptor object に転送します。バインドされた引数（存在する場合）は、RangeAdaptorClosureObject の値カテゴリと cv 修飾を持つと見なされます。言い換えると、a(args...)(r) は std::bind_back(a, args...)(r) と等価ですが、前者はパイプ構文もサポートします。(C++23 以降)

他のカスタマイズポイントオブジェクトと同様に、以下のようにします。

• a が、いずれかの range adaptor object の型の cv 修飾されていないバージョンであるオブジェクトであり、
• args... が、a の型の `operator()` の制約を満たす任意の引数のグループである場合、

以下の呼び出しは

• a(args...),
• std::as_const(a)(args...),
• std::move(a)(args...)、および
• std::move(std::as_const(a))(args...)

すべて等価です。

これらの各式の結果オブジェクトは、view オブジェクトまたは RangeAdaptorClosureObject のいずれかです。

注記

operator() は、range adaptor object 型の volatile 修飾または const-volatile 修飾されたバージョンではサポートされていません。配列と関数は、バインド時にポインタに変換されます。