std::allocator

 

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::allocator

成員函式

allocator::allocator

allocator::~allocator

allocator::address (C++20 前)

allocator::allocate

allocator::allocate_at_least (C++23)

allocator::deallocate

allocator::max_size (C++20 前)

allocator::construct (C++20 前)

allocator::destroy (C++20 前)

非成員函式

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

 

定義於標頭檔案 <memory>
template< class T > struct allocator;	(1)
template<> struct allocator<void>;	(2)	(C++17 中已棄用) (C++20 中移除)

std::allocator 類模板是所有標準庫容器在未提供使用者指定分配器時使用的預設 Allocator。預設分配器是無狀態的，即給定分配器的所有例項都是可互換的，比較相等，並且可以釋放由同一分配器型別的任何其他例項分配的記憶體。

void 的顯式特化缺少成員 typedef reference、const_reference、size_type 和 difference_type。此特化不宣告任何成員函式。

(C++20 前)

預設分配器滿足分配器完整性要求。

(C++17 起)

成員型別

型別	定義
value_type	T
pointer (C++17 中已棄用)(C++20 中已移除)	T*
const_pointer (C++17 中已棄用)(C++20 中已移除)	const T*
reference (C++17 中已棄用)(C++20 中已移除)	T&
const_reference (C++17 中已棄用)(C++20 中已移除)	const T&
size_type	std::size_t
difference_type	std::ptrdiff_t
propagate_on_container_move_assignment (C++11)	std::true_type
rebind (C++17 中已棄用)(C++20 中已移除)	template< class U > struct rebind {     typedef allocator<U> other; };
is_always_equal (C++11)(C++23 中已棄用)(C++26 中已移除)	std::true_type

成員函式

(建構函式)	建立一個新的分配器例項 (公共成員函式)
(解構函式)	銷燬分配器例項 (公共成員函式)
地址 (C++20 前)	獲取物件的地址，即使 operator& 被過載 (公共成員函式)
allocate	分配未初始化的儲存 (公共成員函式)
allocate_at_least (C++23)	分配至少與請求大小一樣大的未初始化儲存 (公共成員函式)
deallocate	釋放儲存 (公共成員函式)
max_size (C++20 前)	返回支援的最大分配大小 (公共成員函式)
construct (C++20 前)	在已分配的儲存中構造物件 (公共成員函式)
destroy (C++20 前)	在已分配的儲存中銷燬物件 (公共成員函式)

非成員函式

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

比較兩個分配器例項 (公共成員函式)

注意

成員模板類 rebind 提供了一種獲取不同型別的分配器的方法。例如，std::list<T, A> 使用分配器 A::rebind<Node<T>>::other(直到 C++11)std::allocator_traits<A>::rebind_alloc<Node<T>> 分配某種內部型別 Node<T> 的節點，如果 A 是 std::allocator，則它根據 A::rebind<Node<T>>::other 實現(C++11 起)。

成員型別 is_always_equal 已透過 LWG issue 3170 棄用，因為它預設將從 std::allocator 派生的自定義分配器視為始終相等。std::allocator_traits<std::allocator<T>>::is_always_equal 未被棄用，其成員常量 value 對於任何 T 都為 true。

示例

執行此程式碼

#include <iostream>
#include <memory>
#include <string>
 
int main()
{
    // default allocator for ints
    std::allocator<int> alloc1;
 
    // demonstrating the few directly usable members
    static_assert(std::is_same_v<int, decltype(alloc1)::value_type>);
    int* p1 = alloc1.allocate(1); // space for one int
    alloc1.deallocate(p1, 1);     // and it is gone
 
    // Even those can be used through traits though, so no need
    using traits_t1 = std::allocator_traits<decltype(alloc1)>; // The matching trait
    p1 = traits_t1::allocate(alloc1, 1);
    traits_t1::construct(alloc1, p1, 7);  // construct the int
    std::cout << *p1 << '\n';
    traits_t1::deallocate(alloc1, p1, 1); // deallocate space for one int
 
    // default allocator for strings
    std::allocator<std::string> alloc2;
    // matching traits
    using traits_t2 = std::allocator_traits<decltype(alloc2)>;
 
    // Rebinding the allocator using the trait for strings gets the same type
    traits_t2::rebind_alloc<std::string> alloc_ = alloc2;
 
    std::string* p2 = traits_t2::allocate(alloc2, 2); // space for 2 strings
 
    traits_t2::construct(alloc2, p2, "foo");
    traits_t2::construct(alloc2, p2 + 1, "bar");
 
    std::cout << p2[0] << ' ' << p2[1] << '\n';
 
    traits_t2::destroy(alloc2, p2 + 1);
    traits_t2::destroy(alloc2, p2);
    traits_t2::deallocate(alloc2, p2, 2);
}

輸出

7
foo bar

缺陷報告

下列更改行為的缺陷報告追溯地應用於以前出版的 C++ 標準。

缺陷報告	應用於	釋出時的行為	正確的行為
LWG 2103	C++11	可能需要 allocator 之間冗餘的比較	提供了 propagate_on_container_move_assignment
LWG 2108	C++11	無法表明 allocator 是無狀態的	提供 is_always_equal

另請參閱

allocator_traits (C++11)	提供關於分配器型別的資訊 (類模板)
scoped_allocator_adaptor (C++11)	為多層容器實現多層分配器 (類模板)
uses_allocator (C++11)	檢查指定型別是否支援 uses-allocator 構造 (類模板)