std::uses_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)

 

定義於標頭檔案 <memory>
template< class T, class Alloc > struct uses_allocator;		(C++11 起)

如果 T 具有巢狀型別 allocator_type，並且該型別可從 Alloc 轉換，則成員常量 value 為 true。否則，value 為 false。

輔助變數模板

template< class T, class Alloc > constexpr bool uses_allocator_v = uses_allocator<T, Alloc>::value;		(C++17 起)

繼承自 std::integral_constant

成員常量

value [靜態]

如果 T 使用分配器 Alloc 則為 true，否則為 false (public static 成員常量)

成員函式

operator bool	將物件轉換為 bool，返回 value (公開成員函式)
operator() (C++14)	返回 value (公開成員函式)

成員型別

型別	定義
value_type	bool
型別	std::integral_constant<bool, value>

使用分配器構造

將分配器 alloc 傳遞給某種型別 T 的建構函式有三種約定

• 如果 T 不使用相容的分配器（std::uses_allocator_v<T, Alloc> 為 false），則忽略 alloc。
• 否則，std::uses_allocator_v<T, Alloc> 為 true，且

• 如果 T 使用“前導分配器約定”（可作為 T(std::allocator_arg, alloc, args...) 呼叫），則使用分配器構造採用此形式。
• 如果 T 使用“尾隨分配器約定”（可作為 T(args..., alloc) 呼叫），則使用分配器構造採用此形式。
• 否則，程式格式錯誤（這意味著 std::uses_allocator_v<T, Alloc> 為 true，但該型別不遵循兩種允許的約定中的任何一種）。

• 作為特例，std::pair 被視為使用分配器型別，即使對於 pair 而言 std::uses_allocator 為 false（不像例如 std::tuple）：請參閱 std::pmr::polymorphic_allocator::construct 和 std::scoped_allocator_adaptor::construct 的 pair 特有過載(C++20 前)std::uses_allocator_construction_args(C++20 起)。

工具函式 std::make_obj_using_allocator 和 std::uninitialized_construct_using_allocator 可用於顯式建立遵循上述協議的物件，而 std::uses_allocator_construction_args 可用於準備與型別期望的使用分配器構造方式匹配的引數列表。

(C++20 起)

特化

給定一個沒有巢狀 allocator_type 的程式定義型別 T，如果滿足以下任一要求，程式可以特化 std::uses_allocator 以從 std::true_type 派生用於 T

• T 具有一個建構函式，它將 std::allocator_arg_t 作為第一個引數，將 Alloc 作為第二個引數。
• T 具有一個建構函式，它將 Alloc 作為最後一個引數。

在上述中，Alloc 是一個滿足 Allocator 或可轉換為 std::experimental::pmr::memory_resource* 的指標型別(庫基礎 TS) 的型別。

標準庫已提供以下特化

std::uses_allocator<std::tuple> (C++11)	特化 std::uses_allocator 型別特性 (類模板特化)
std::uses_allocator<std::queue> (C++11)	特化 std::uses_allocator 型別特性 (類模板特化)
std::uses_allocator<std::priority_queue> (C++11)	特化 std::uses_allocator 型別特性 (類模板特化)
std::uses_allocator<std::stack> (C++11)	特化 std::uses_allocator 型別特性 (類模板特化)
std::uses_allocator<std::flat_map> (C++23)	特化 std::uses_allocator 型別特性 (類模板特化)
std::uses_allocator<std::flat_set> (C++23)	特化 std::uses_allocator 型別特性 (類模板特化)
std::uses_allocator<std::flat_multimap> (C++23)	特化 std::uses_allocator 型別特性 (類模板特化)
std::uses_allocator<std::flat_multiset> (C++23)	特化 std::uses_allocator 型別特性 (類模板特化)
std::uses_allocator<std::function> (C++11) (直到 C++17)	特化 std::uses_allocator 型別特性 (類模板特化)
std::uses_allocator<std::promise> (C++11)	特化 std::uses_allocator 型別特性 (類模板特化)
std::uses_allocator<std::packaged_task> (C++11) (直到 C++17)	特化 std::uses_allocator 型別特性 (類模板特化)

註解

此型別特性由 std::tuple、std::scoped_allocator_adaptor 和 std::pmr::polymorphic_allocator 使用。它也可以由自定義分配器或包裝型別使用，以確定被構造的物件或成員本身是否能夠使用分配器（例如，是否為容器），在這種情況下，應將分配器傳遞給其建構函式。

參閱

allocator_argallocator_arg_t (C++11)	用於選擇分配器感知建構函式的標記 (標記)
uses_allocator_construction_args (C++20)	準備與給定型別所需的使用分配器構造方式匹配的引數列表 (函式模板)
make_obj_using_allocator (C++20)	透過 uses-allocator 構造建立給定型別的物件 (函式模板)
uninitialized_construct_using_allocator (C++20)	透過使用分配器構造在指定記憶體位置建立給定型別的物件 (函式模板)
scoped_allocator_adaptor (C++11)	為多層容器實現多層分配器 (類模板)