std:: scoped_allocator_adaptor

Die std::scoped_allocator_adaptor -Klassentemplate ist ein Allokator, der mit mehrstufigen Containern verwendet werden kann (Vektor von Sets von Listen von Tupeln von Maps, etc.). Sie wird mit einem äußeren Allokatortyp OuterAlloc und null oder mehr inneren Allokatortypen InnerAlloc... instanziiert. Ein Container, der direkt mit einem scoped_allocator_adaptor konstruiert wird, verwendet OuterAlloc zur Allokation seiner Elemente, aber wenn ein Element selbst ein Container ist, verwendet es den ersten inneren Allokator. Die Elemente dieses Containers, falls sie selbst Container sind, verwenden den zweiten inneren Allokator, usw. Wenn es mehr Ebenen im Container als innere Allokatoren gibt, wird der letzte innere Allokator für alle weiteren verschachtelten Container wiederverwendet.

Der Zweck dieses Adapters ist die korrekte Initialisierung zustandsbehafteter Allokatoren in geschachtelten Containern, beispielsweise wenn alle Ebenen eines geschachtelten Containers im selben Shared-Memory-Segment platziert werden müssen. Der Konstruktor des Adapters nimmt die Argumente für alle Allokatoren in der Liste entgegen, und jeder geschachtelte Container bezieht den Zustand seines Allokators bei Bedarf vom Adapter.

Für den Zweck von scoped_allocator_adaptor , wenn der nächste innere Allokator A ist, nimmt jede Klasse T , für die std:: uses_allocator < T,A > :: value == true an der Rekursion teil, als ob sie ein Container wäre. Zusätzlich wird std::pair durch spezifische Überladungen von scoped_allocator_adaptor::construct als ein solcher Container behandelt.

Typische Implementierungen halten eine Instanz eines std::scoped_allocator_adaptor<InnerAllocs...> als Mitgliedsobjekt.

Beachten Sie, dass std::pmr::polymorphic_allocator s gemäß Uses-allocator-Konstruktion zu verschachtelten Containern propagieren und std::scoped_allocator_adaptor nicht benötigen (und nicht damit funktionieren).

Verschachtelte Typen

Gegeben die Menge von OuterAlloc und InnerAlloc... als Allocs :

Memberfunktionen

Nicht-Member-Funktionen

Deduction guides (seit C++17)

Geschachtelte Klassen

Beispiel

#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);
    // Vektor von Vektoren im Shared Memory erstellen
    ipc_matrix v(s.get_segment_manager());
    // Für alle diese Erweiterungen erhalten die inneren Vektoren ihre Allokator-Argumente
    // vom scoped_allocator_adaptor des äußeren Vektors
    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");
}

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

Siehe auch