SysTutorials

Linux Manual Pages › Section 3

stdpmrpolymorphic_allocatordeallocate_object(3)

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

Synopsis

template <class U>
(since C++ 20)
    void deallocate_object(U *p, std::size_t n = 1);
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::polymorphic_allocator<>, but it may be useful in any specialization.

See also

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