std::make_obj_using_allocator (3) - Linux Manuals

std::make_obj_using_allocator: std::make_obj_using_allocator

NAME

std::make_obj_using_allocator - std::make_obj_using_allocator

Synopsis


Defined in header <memory>
template< class T, class Alloc, class... Args > (since C++20)
T make_obj_using_allocator( const Alloc& alloc, Args&&... args )


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


 This section is incomplete
 Reason: no example

See also


uses_allocator_construction_args prepares the argument list matching the flavor of uses-allocator construction required by the given type
                                        (function template)
(C++20)


uninitialized_construct_using_allocator creates an object of the given type at specified memory location by means of uses-allocator construction
                                        (function template)
(C++20)