std::make_obj_using_allocator

From cppreference.com
< cpp‎ | memory
Memory management library
(exposition only*)
Uninitialized memory algorithms
(C++17)
(C++17)
(C++17)
(C++20)
Constrained uninitialized
memory algorithms
(C++20)
C Library

Allocators
(C++11)
(C++11)
make_obj_using_allocator
(C++20)
Memory resources
Garbage collection support
(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)
Uninitialized storage
(until C++20*)
(until C++20*)
(until C++20*)
Explicit lifetime management
Defined in header <memory>
template < class T, class Alloc, class... Args >
constexpr T make_obj_using_allocator( const Alloc& alloc, Args&&... args ) ;
(since C++20)

Creates an object of the given type T by means of uses-allocator construction.

Equivalent to

Parameters

alloc - the allocator to use
args - the arguments to pass to T's constructor

Return value

The newly-created object of type T.

Exceptions

May throw any exception thrown by the constructor of T, typically including std::bad_alloc.

Example

See also

prepares the argument list matching the flavor of uses-allocator construction required by the given type
(function template)
creates an object of the given type at specified memory location by means of uses-allocator construction
(function template)