std::scoped_allocator_adaptor

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

記憶體管理庫

voidify (僅作說明*) 未初始化記憶體演算法 uninitialized_copy uninitialized_fill uninitialized_move (C++17) uninitialized_default_construct (C++17) uninitialized_value_construct (C++17) destroy (C++17) destroy_at (C++17) uninitialized_copy_n (C++11) uninitialized_fill_n uninitialized_move_n (C++17) uninitialized_default_construct_n (C++17) uninitialized_value_construct_n (C++17) destroy_n (C++17) construct_at (C++20) 受約束的未初始化 記憶體演算法 ranges::uninitialized_copy (C++20) ranges::uninitialized_fill (C++20) ranges::uninitialized_move (C++20) ranges::construct_at (C++20) ranges::destroy (C++20) ranges::destroy_n (C++20) ranges::destroy_at (C++20) ranges::uninitialized_copy_n (C++20) ranges::uninitialized_fill_n (C++20) ranges::uninitialized_move_n (C++20) ranges::uninitialized_default_construct (C++20) ranges::uninitialized_value_construct (C++20) ranges::uninitialized_default_construct_n (C++20)  ranges::uninitialized_value_construct_n (C++20) C 庫 malloc calloc realloc aligned_alloc (C++17) free

分配器 allocator allocator_traits (C++11) allocation_result (C++23) allocator_arg (C++11) uses_allocator (C++11) uses_allocator_construction_args (C++20) make_obj_using_allocator (C++20) uninitialized_construct_using_allocator (C++20)  scoped_allocator_adaptor (C++11) pmr::polymorphic_allocator (C++17) 記憶體資源 pmr::memory_resource (C++17) pmr::get_default_resource (C++17) pmr::set_default_resource (C++17) pmr::new_delete_resource (C++17) pmr::null_memory_resource (C++17) pmr::synchronized_pool_resource (C++17) pmr::unsynchronized_pool_resource (C++17) pmr::monotonic_buffer_resource (C++17) pmr::pool_options (C++17) 垃圾回收支援 declare_reachable (C++11)(直到 C++23) undeclare_reachable (C++11)(直到 C++23) declare_no_pointers (C++11)(直到 C++23) undeclare_no_pointers (C++11)(直到 C++23) pointer_safety (C++11)(直到 C++23) get_pointer_safety (C++11)(直到 C++23) 未初始化儲存 raw_storage_iterator (直到 C++20*) get_temporary_buffer (直到 C++20*) return_temporary_buffer (直到 C++20*) 顯式生命週期管理 start_lifetime_asstart_lifetime_as_array (C++23)(C++23)

智慧指標 unique_ptr (C++11) shared_ptr (C++11) weak_ptr (C++11) auto_ptr (直到 C++17*) owner_less (C++11) owner_less<void> (C++17) owner_hash (C++26) owner_equal (C++26) enable_shared_from_this (C++11) bad_weak_ptr (C++11) default_delete (C++11) out_ptr_t (C++23) inout_ptr_t (C++23) 低階記憶體 管理 operator new operator new[] operator delete operator delete[] get_new_handler (C++11) set_new_handler launder (C++17) bad_alloc bad_array_new_length (C++11) nothrow_t align_val_t (C++17) destroying_delete_t (C++20) new_handler nothrow 雜項 pointer_traits (C++11) to_address (C++20) addressof (C++11) align (C++11) assume_aligned (C++20) is_sufficiently_aligned (C++26)

 

std::scoped_allocator_adaptor

成員函式

scoped_allocator_adaptor::scoped_allocator_adaptor

scoped_allocator_adaptor::~scoped_allocator_adaptor

scoped_allocator_adaptor::operator=

scoped_allocator_adaptor::inner_allocator

scoped_allocator_adaptor::outer_allocator

scoped_allocator_adaptor::allocate

scoped_allocator_adaptor::deallocate

scoped_allocator_adaptor::max_size

scoped_allocator_adaptor::construct

scoped_allocator_adaptor::destroy

scoped_allocator_adaptor::select_on_container_copy_construction

scoped_allocator_adaptor::outermost scoped_allocator_adaptor::outermost-construct scoped_allocator_adaptor::outermost-destroy

非成員函式

operator==operator!= (until C++20)

推導指南(C++17)

 

定義於標頭檔案 <scoped_allocator>
template< class OuterAlloc, class... InnerAllocs > class scoped_allocator_adaptor     : public OuterAlloc;		(C++11 起)

std::scoped_allocator_adaptor 類模板是一個分配器，可用於多級容器（`vector` 的 `set` 的 `list` 的 `tuple` 的 `map` 等）。它例項化一個外部分配器型別 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 配合使用。

巢狀型別

型別	定義
outer_allocator_type	OuterAlloc
inner_allocator_type	scoped_allocator_adaptor<OuterAlloc> 如果 sizeof...(InnerAllocs) 為零 否則為 scoped_allocator_adaptor<InnerAllocs...>
value_type	std::allocator_traits<OuterAlloc>::value_type
size_type	std::allocator_traits<OuterAlloc>::size_type
difference_type	std::allocator_traits<OuterAlloc>::difference_type
pointer	std::allocator_traits<OuterAlloc>::pointer
const_pointer	std::allocator_traits<OuterAlloc>::const_pointer
void_pointer	std::allocator_traits<OuterAlloc>::void_pointer
const_void_pointer	std::allocator_traits<OuterAlloc>::const_void_pointer

給定 OuterAlloc 和 InnerAlloc... 為 Allocs 集合

型別	定義
propagate_on_container_copy_assignment	std::true_type 如果 Allocs 中存在型別 A，使得 std::allocator_traits<A>::     propagate_on_container_copy_assignment::value 為 true 否則為 std::false_type
propagate_on_container_move_assignment	std::true_type 如果 Allocs 中存在型別 A，使得 std::allocator_traits<A>::     propagate_on_container_move_assignment::value 為 true 否則為 std::false_type
propagate_on_container_swap	std::true_type 如果 Allocs 中存在型別 A，使得 std::allocator_traits<A>::     propagate_on_container_swap::value 為 true 否則為 std::false_type
is_always_equal	std::true_type 如果 Allocs 中存在型別 A，使得 std::allocator_traits<A>::     is_always_equal::value 為 true 否則為 std::false_type

成員函式

(建構函式)	建立一個新的 scoped_allocator_adaptor 物件 (公共成員函式)
(解構函式)	銷燬 scoped_allocator_adaptor 物件 (公共成員函式)
operator=	賦值 scoped_allocator_adaptor (公共成員函式)
inner_allocator	獲取 inner_allocator 引用 (公共成員函式)
outer_allocator	獲取 outer_allocator 引用 (公共成員函式)
allocate	使用外部分配器分配未初始化的儲存 (公共成員函式)
deallocate	使用外部分配器解除分配儲存 (公共成員函式)
max_size	返回外部分配器支援的最大分配大小 (公共成員函式)
construct	在已分配的儲存中構造物件，如果合適則將內部分配器傳遞給其建構函式 (公共成員函式)
destroy	在已分配的儲存中銷燬物件 (公共成員函式)
select_on_container_copy_construction	複製 scoped_allocator_adaptor 及其所有分配器的狀態 (公共成員函式)
僅用於說明的函式模板
outermost	獲取最外部的分配器 (僅用於說明的成員函式*)
outermost-construct	使用最外部的分配器構造物件 (僅用於說明的成員函式*)
outermost-destroy	使用最外部的分配器銷燬物件 (僅用於說明的成員函式*)

非成員函式

operator==operator!= (在 C++20 中移除)

比較兩個 scoped_allocator_adaptor 物件 (函式模板)

巢狀類

類	定義
rebind	template< class T > struct rebind {     using other = scoped_allocator_adaptor                       <std::allocator_traits<OuterAlloc>::template rebind_alloc<T>,                        InnerAllocs...>; };

示例

執行此程式碼

#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++ 標準。

缺陷報告	應用於	釋出時的行為	正確的行為
LWG 2108	C++11	沒有辦法表明 scoped_allocator_adaptor 是否是無狀態的	提供了 is_always_equal

另見

allocator_traits (C++11)	提供關於分配器型別的資訊 (類模板)
uses_allocator (C++11)	檢查指定型別是否支援 uses-allocator 構造 (類模板)
allocator	預設分配器 (類模板)