table of contents
std::pmr::polymorphic_allocator::deallocate_object(3) | C++ Standard Libary | std::pmr::polymorphic_allocator::deallocate_object(3) |
NAME¶
std::pmr::polymorphic_allocator::deallocate_object - std::pmr::polymorphic_allocator::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::pmr::polymorphic_allocator<>, but it may be useful in any
specialization.
See also¶
deallocate_bytes Free raw memory obtained from allocate_bytes
(C++20) (public member function)
delete_object Destroys and deallocates an object
(C++20) (public member function)
deallocate deallocates storage using the allocator
[static] (public static member function of
std::allocator_traits<Alloc>)
deallocate deallocates memory
(public member function of std::pmr::memory_resource)
2022.07.31 | http://cppreference.com |