std::allocator_traits<Alloc>::construct

 

C++

语言

标准库头文件

自立与有宿主实现

具名要求

语言支持库

概念库 (C++20)

诊断库

工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

原子操作库 (C++11)

线程支持库 (C++11)

技术规范

 

动态内存管理

智能指针 unique_ptr (C++11) shared_ptr (C++11) weak_ptr (C++11) auto_ptr (C++17 前) owner_less (C++11) 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) 分配器 allocator allocator_traits (C++11) allocation_result (C++23) allocate_at_least (C++23) allocator_arg_t (C++11) 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) 未初始化存储 raw_storage_iterator (C++20 前) get_temporary_buffer (C++20 前) return_temporary_buffer (C++20 前)

未初始化内存算法 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::uninitialized_default_construct (C++20) ranges::uninitialized_value_construct (C++20) ranges::destroy (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_n (C++20) ranges::uninitialized_value_construct_n (C++20) ranges::destroy_n (C++20) ranges::construct_at (C++20) 垃圾收集支持 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 前) 杂项 pointer_traits (C++11) to_address (C++20) addressof (C++11) align (C++11) assume_aligned (C++20) C 库 malloc aligned_alloc (C++17) calloc realloc free 低层内存管理

 

std::allocator_traits

成员函数

allocator_traits::allocate

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 前)
template< class T, class... Args > static constexpr void construct( Alloc& a, T* p, Args&&... args );		(C++20 起)

若可能，则在 p 所指向的分配的未初始化存储构造 T 类型对象，通过调用

a.construct(p, std::forward<Args>(args)...)

若以上不可行（例如 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++17 中弃用)(C++20 中移除)	在分配的存储构造对象 (std::allocator<T> 的公开成员函数)