std::make_obj_using_allocator

< cpp‎ | memory
 
 
 
Dynamic memory management
Uninitialized storage
(C++17)
Garbage collection support
Miscellaneous
(C++20)
(C++11)
(C++11)
C Library
Low level memory management
 
Defined in header <memory>
template< class T, class Alloc, class... Args >
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

return std::make_from_tuple<T>(
    std::uses_allocator_construction_args<T>(alloc, std::forward<Args>(args)...)
);

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)