std::pmr::polymorphic_allocator::new_object - cppreference.com (original) (raw)

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

Allocates and constructs an object of type U.

Given alloc is a std::pmr::polymorphic_allocator<T>:

U* p = alloc.new_object(std::forward(ctor_args)...);

is equivalent to

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

[edit] Parameters

[edit] Return value

A pointer to the allocated and constructed object.

[edit] Notes

This function was introduced for use with the fully-specialized allocator std::pmr::polymorphic_allocator<>, but it may be useful in any specialization as a shortcut to avoid having to rebind from std::pmr::polymorphic_allocator<T> to std::pmr::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.

[edit] Exceptions

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

[edit] See also

| | allocate raw aligned memory from the underlying resource (public member function) [edit] | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | allocates raw memory suitable for an object or an array (public member function) [edit] | | | allocate memory (public member function) [edit] | | | allocates uninitialized storage using the allocator (public static member function of std::allocator_traits) [edit] | | | allocates memory (public member function of std::pmr::memory_resource) [edit] |