[#BloombergLP-bslma-Allocator-deallocate-078]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bslma.adoc[bslma]::xref:BloombergLP/bslma/Allocator.adoc[Allocator]::deallocate
:relfileprefix: ../../../
:mrdocs:

Return the memory block at the specified `address` to this allocator.

== Synopsis

Declared in `<bslma_allocator.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
virtual
void
deallocate(void* address) = 0;
----

== Description

Return the memory block at the specified `address` back to this allocator. If `address` is 0, this function has no effect. The behavior is undefined unless `address` was allocated using this allocator object and has not already been deallocated. Note that this virtual function hides a three‐parameter, non‐virtual `deallocate` method inherited from `bsl::memory_resource`; to access the inherited function, upcast the object to `bsl::memory_resource&` before calling the base‐class function.


[.small]#Created with https://www.mrdocs.com[MrDocs]#