SysTutorials

Linux Manual Pages › Section 3

stdpmrpolymorphic_allocatordeallocate_bytes(3)

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

Synopsis

void deallocate_bytes(void *p,
                      std::size_t nbytes, (since C++ 20)
                                              std::size_t alignment = alignof(std::max_align_t));
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(nbytes, alignment), typically through a call to allocate_bytes(nbytes, alignment.
Equivalent to resorce()->deallocate(p, nbytes, alignment);

Parameters

p – pointer to memory to deallocate
nbytes – the number of bytes originally allocated
alignment – the alignment originally allocated

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_object Frees raw memory obtained by allocate_object
                  (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)