std:: scoped_allocator_adaptor

std::scoped_allocator_adaptor クラステンプレートは、多階層コンテナ（ベクターのセットのリストのタプルのマップなど）で使用できるアロケータです。これは1つの外側アロケータ型 OuterAlloc と0個以上の内側アロケータ型 InnerAlloc... でインスタンス化されます。 scoped_allocator_adaptor で直接構築されたコンテナは OuterAlloc を使用してその要素を割り当てますが、要素自体がコンテナである場合は最初の内側アロケータを使用します。そのコンテナの要素がそれ自体コンテナである場合は、2番目の内側アロケータを使用します。コンテナの階層が内側アロケータの数より多い場合、最後の内側アロケータがそれ以降のネストされたコンテナすべてで再利用されます。

このアダプタの目的は、ネストされたコンテナ内のステートフルなアロケータを正しく初期化することです。例えば、ネストされたコンテナのすべてのレベルが同じ共有メモリセグメントに配置されなければならない場合などです。このアダプタのコンストラクタは、リスト内のすべてのアロケータに対する引数を受け取り、各ネストされたコンテナは必要に応じてアロケータの状態をアダプタから取得します。

scoped_allocator_adaptor の目的において、次の内部アロケータが A である場合、 std:: uses_allocator < T,A > :: value == true である任意のクラス T は、あたかもコンテナであるかのように再帰に参加します。さらに、 std::pair は、 scoped_allocator_adaptor::construct の特定のオーバーロードによって、そのようなコンテナとして扱われます。

典型的な実装では、メンバーオブジェクトとして std::scoped_allocator_adaptor<InnerAllocs...> のインスタンスを保持します。

std::pmr::polymorphic_allocator s がネストされたコンテナに伝播する際は uses-allocator construction に従い、 std::scoped_allocator_adaptor は必要とせず（また動作しません）ことに注意してください。

ネストされた型

与えられた OuterAlloc と InnerAlloc... のセットを Allocs として：

メンバー関数

非メンバー関数

推論ガイド (C++17以降)

ネストされたクラス

例

#include <boost/interprocess/allocators/adaptive_pool.hpp>
#include <boost/interprocess/managed_shared_memory.hpp>
#include <scoped_allocator>
#include <vector>
namespace bi = boost::interprocess;
template<class T>
using alloc = bi::adaptive_pool<T, bi::managed_shared_memory::segment_manager>;
using ipc_row = std::vector<int, alloc<int>>;
using ipc_matrix = std::vector<ipc_row, std::scoped_allocator_adaptor<alloc<ipc_row>>>;
int main()
{
    bi::managed_shared_memory s(bi::create_only, "Demo", 65536);
    // 共有メモリ内でのベクトルのベクトルを作成
    ipc_matrix v(s.get_segment_manager());
    // これらの追加操作では、内部ベクトルはそのアロケータ引数を
    // 外部ベクトルのscoped_allocator_adaptorから取得する
    v.resize(1);
    v[0].push_back(1);
    v.emplace_back(2);
    std::vector<int> local_row = {1, 2, 3};
    v.emplace_back(local_row.begin(), local_row.end());
    bi::shared_memory_object::remove("Demo");
}

欠陥報告

以下の動作変更の欠陥報告書は、以前に公開されたC++規格に対して遡及的に適用されました。

関連項目