W3cubDocs

/C++

std::pmr::polymorphic_allocator<T>::new_object

template< class U, class CtorArgs... >
U* new_object( CtorArgs&&... ctor_args );
(since C++20)

Allocates and constructs an object of type U.

Equivalent to.

U* p = allocate_object<U>();
try {
  construct(p, std::forward<CtorArgs>(ctor_args)...);
} catch (...) {
  deallocate_object(p);
  throw;
}
return p;

Parameters

ctor_args - the arguments to forward to the the constructor of U

Return value

A pointer to the allocated and constructed object.

Notes

This function was introduced for use with the fully-specialized allocator std::polymorphic_allocator<>, but it may be useful in any specialization as a shortcut to avoid having to rebind from std::polymorphic_allocator<T> to std::polymorphic_allocator<U>, and having to call allocate, construct, and deallocate individually.

Since U is not deduced, it must be provided as a template argument when calling this function.

Exceptions

May throw any exceptions thrown by the call to allocate_object or the constructor of U.

See also

(C++20)
Allocate raw aligned memory from the underlying resource
(public member function)
(C++20)
Allocates raw memory suitable for an object or an array
(public member function)
Allocate memory
(public member function)
[static]
allocates uninitialized storage using the allocator
(public static member function of std::allocator_traits<Alloc>)
allocates memory
(public member function of std::pmr::memory_resource)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
http://en.cppreference.com/w/cpp/memory/polymorphic_allocator/new_object