std::pmr::polymorphic_allocator<T>::deallocate_object (3) - Linux Man Pages

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

NAME

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)