Scroll to navigation

std::pmr::polymorphic_allocator::deallocate_bytes(3) C++ Standard Libary std::pmr::polymorphic_allocator::deallocate_bytes(3)

NAME

std::pmr::polymorphic_allocator::deallocate_bytes - std::pmr::polymorphic_allocator::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 resource()->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::pmr::polymorphic_allocator<>, but it may be useful in any specialization.

See also


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