std::pmr::polymorphic_allocator<T>::deallocate_object

From cppreference.com
Memory management library
(exposition only*)
Uninitialized memory algorithms
(C++17)
(C++17)
(C++17)
(C++20)
Constrained uninitialized
memory algorithms
(C++20)
C Library

Allocators
(C++11)
(C++11)
Memory resources
Garbage collection support
(C++11)(until C++23)
(C++11)(until C++23)
(C++11)(until C++23)
(C++11)(until C++23)
(C++11)(until C++23)
(C++11)(until C++23)
Uninitialized storage
(until C++20*)
(until C++20*)
(until C++20*)
Explicit lifetime management
template < class U >
void deallocate_object( U* p, std::size_t n = 1 ) ;
(since C++20)

Deallocates the storage pointed to by p, which must have been allocated from a std::pmr::memory_resource x that compares equal to *resource(), using x.allocate (n * sizeof(U), alignof(U) ) , typically through a call to allocate_object<U>(n)

Equivalent to deallocate_bytes(p, n * sizeof(U), alignof(U) ) ;

Parameters

p - pointer to memory to deallocate
n - number of objects of type U the memory was for

Exceptions

Throws nothing.

Notes

This function was introduced for use with the fully-specialized allocator std::pmr::polymorphic_allocator <>

See also

free raw memory obtained from allocate_bytes
(public member function)
(C++20)
destroys and deallocates an object
(public member function)
[static]
deallocates storage using the allocator
(public static member function of std::allocator_traits<Alloc>)
deallocates memory
(public member function of std::pmr::memory_resource)