std::scoped_allocator_adaptor

template< class OuterAlloc, class... InnerAllocs >
class scoped_allocator_adaptor
    : public OuterAlloc;

Шаблон класса std::scoped_allocator_adaptor — это аллокатор, который можно использовать с многоуровневыми контейнерами (вектор множеств списков кортежей отображений и т. д.). Он создаётся с одним внешним типом аллокатора OuterAlloc и нулём или более внутренними типами аллокаторов InnerAlloc.... Контейнер, непосредственно созданный с помощью scoped_allocator_adaptor, использует OuterAlloc для выделения памяти под свои элементы, но если элемент сам является контейнером, он использует первый внутренний аллокатор. Элементы этого контейнера, если они сами являются контейнерами, используют второй внутренний аллокатор и т. д. Если уровней вложенности контейнера больше, чем внутренних аллокаторов, последний внутренний аллокатор повторно используется для всех последующих вложенных контейнеров.

Назначение этого адаптера — правильно инициализировать аллокаторы с состоянием во вложенных контейнерах, например, когда все уровни вложенного контейнера должны находиться в одном сегменте разделяемой памяти. Конструктор адаптера принимает аргументы для всех аллокаторов в списке, а каждый вложенный контейнер при необходимости получает состояние своего аллокатора от адаптера.

Для целей scoped_allocator_adaptor, если следующий внутренний аллокатор — A, любой класс T, для которого std::uses_allocator<T,A>::value == true, участвует в рекурсии так, как если бы он был контейнером. Кроме того, std::pair рассматривается как такой контейнер специальными перегрузками scoped_allocator_adaptor::construct.

Типичная реализация содержит экземпляр std::scoped_allocator_adaptor<InnerAllocs...> в качестве объекта-члена.

Обратите внимание, что std::pmr::polymorphic_allocator распространяются на вложенные контейнеры согласно конструированию с использованием аллокатора и не требуют 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);
    
    // create vector of vectors in shared memory
    ipc_matrix v(s.get_segment_manager());
    
    // for all these additions, the inner vectors obtain their allocator arguments
    // from the outer vector's 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++.

См. также