std::allocator::construct

 

C++

Language

Standard library headers

Concepts

Utilities library

Strings library

Containers library

Algorithms library

Iterators library

Numerics library

Input/output library

Localizations library

Regular expressions library (C++11)

Atomic operations library (C++11)

Thread support library (C++11)

Filesystem library (C++17)

Technical Specifications

 

Dynamic memory management

Smart pointers unique_ptr (C++11) shared_ptr (C++11) weak_ptr (C++11) auto_ptr (until C++17) owner_less (C++11) enable_shared_from_this (C++11) bad_weak_ptr (C++11) default_delete (C++11) Allocators allocator allocator_traits (C++11) allocator_arg_t (C++11) allocator_arg (C++11) uses_allocator (C++11) scoped_allocator_adaptor (C++11) pmr::polymorphic_allocator (C++17) Memory resources 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)

Uninitialized storage uninitialized_copy uninitialized_copy_n (C++11) uninitialized_fill uninitialized_fill_n raw_storage_iterator get_temporary_buffer return_temporary_buffer Garbage collection support declare_reachable (C++11) undeclare_reachable (C++11) declare_no_pointers (C++11) undeclare_no_pointers (C++11) pointer_safety (C++11) get_pointer_safety (C++11) Miscellaneous pointer_traits (C++11) addressof (C++11) align (C++11) C Library malloc calloc realloc free Low level memory management

 

std::allocator

Member functions

allocator::allocator

allocator::~allocator

allocator::address

allocator::allocate

allocator::deallocate

allocator::max_size

allocator::construct

allocator::destroy

Non-member functions

operator==operator!=

 

Defined in header <memory>
void construct( pointer p, const_reference val );	(1)	(until C++11)
template< class U, class... Args > void construct( U* p, Args&&... args );	(2)	(since C++11)

Constructs an object of type T in allocated uninitialized storage pointed to by p, using placement-new

1) Calls new((void *)p) T(val)

2) Calls ::new((void *)p) U(std::forward<Args>(args)...)

Parameters

p	-	pointer to allocated uninitialized storage
val	-	the value to use as the copy constructor argument
args...	-	the constructor arguments to use

Return value

(none)

See also

construct [static]	constructs an object in the allocated storage (function template)
operator newoperator new[]	allocation functions (function)