Function template uninitialized_construct_using

Function template uninitialized_construct_using_allocator

boost::container::uninitialized_construct_using_allocator

Synopsis

// In header: <boost/container/uses_allocator_construction.hpp>


template<typename T, typename AllocArg, class... Args> 
  T * uninitialized_construct_using_allocator(T * p, AllocArg && alloc_arg, 
                                              Args &&... args);

Description

Effects: Creates an object of the given type T by means of uses-allocator construction (see uses_allocator) at the uninitialized memory, where:

p is the memory location where the object will be placed
alloc_arg is the allocator argument whose type AllocArg will be used to evaluate uses_allocator<T, AllocArg>::value
args are the arguments to pass to T's constructor.

Returns: Pointer to the newly-created object of type T

Throws: Any exception thrown by the constructor of T.