std::allocator<T>::construct
From cppreference.com
C++
Feature test macros (C++20)
Concepts library (C++20)
Metaprogramming library (C++11)
Ranges library (C++20)
Filesystem library (C++17)
Concurrency support library (C++11)
Execution control library (C++26)
Memory management library
Uninitialized memory algorithms
Constrained uninitialized memory algorithms
Memory resources
Uninitialized storage (until C++20)
Garbage collector support (until C++23)
(exposition only*)
(C++11)
(C++23)
(C++11)
(C++17)
(C++11)
(C++11)
(C++20)
(C++20)
(C++17)
(C++11)
(C++17)
(C++20)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(until C++20*)
(until C++20*)
(until C++20*)
(C++11)(until C++23)
(C++11)(until C++23)
(C++11)(until C++23)
(C++11)(until C++23)
(C++11)(until C++23)
(C++11)(until C++23)
(C++11)
(C++11)
(C++17)
(C++20)
(C++17)
(C++11)
(C++11)
(C++11)
(until C++17*)
(C++11)
(C++17)
(C++26)
(C++26)
(C++11)
(C++11)
(C++11)
(C++23)
(C++23)
(C++11)
(C++20)
(C++11)
(C++11)
(C++20)
(C++26)
std::allocator
Member functions
(until C++20)
(C++23)
(until C++20)
allocator::construct
(until C++20)
(until C++20)
Non-member functions
(until C++20)
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) void construct( U* p, Args&&... args );
(deprecated in C++17)
(removed in C++20)
Constructs an object of type T in allocated uninitialized storage pointed to by p, using global placement-new.
1) Calls ::new((void*)p) T(val).
2) Calls ::new((void*)p) U(std::forward <Args>(args)...).
[edit] Parameters
p
-
pointer to allocated uninitialized storage
val
-
the value to use as the copy constructor argument
args...
-
the constructor arguments to use
[edit] Return value
(none)
[edit] Defect reports
The following behavior-changing defect reports were applied retroactively to previously published C++ standards.
| DR | Applied to | Behavior as published | Correct behavior |
|---|---|---|---|
| LWG 402 | C++98 | if T::operator new exists, the program might be ill-formed | uses global replacement-new instead |