std::allocator_traits<Alloc>::construct

 

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_traits

成員型別

成員函式

allocator_traits::allocate

allocator_traits::allocate_at_least （C++23）

allocator_traits::deallocate

allocator_traits::construct

allocator_traits::destroy

allocator_traits::max_size

allocator_traits::select_on_container_copy_construction

 

定義於標頭檔案 <memory>
template< class T, class... Args > static void construct( Alloc& a, T* p, Args&&... args );		(C++11 起) (C++20 起為 constexpr)

若可能，則透過呼叫 a.construct(p, std::forward<Args>(args)...)，在 p 所指向的已分配的未初始化儲存中構造 T 型別的物件。

若上述操作不可能（例如 Alloc 沒有成員函式 construct()），則呼叫

::new (static_cast<void*>(p)) T(std::forward<Args>(args)...)	(C++20 前)
std::construct_at(p, std::forward<Args>(args)...)	(C++20 起)

引數

a	-	用於構造的分配器
p	-	指向將被構造 T 物件的未初始化儲存的指標
args...	-	要傳遞給 a.construct() 或 放置 new（C++20 前）std::construct_at()（C++20 起） 的建構函式引數

返回值

(無)

注意

標準庫容器在插入、複製或移動元素時使用此函式。

因為此函式提供了對放置 new 的自動回退，所以自 C++11 起，成員函式 construct() 是一個可選的分配器 (Allocator) 要求。

參閱

operator newoperator new[]	分配函式 （函式）
construct (C++20 前)	在已分配的儲存中構造物件 （std::allocator<T> 的公開成員函式）
construct_at （C++20）	在給定地址建立物件 （函式模板）