[#BloombergLP-bsltf-StdStatefulAllocator-deallocate]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bsltf.adoc[bsltf]::xref:BloombergLP/bsltf/StdStatefulAllocator.adoc[StdStatefulAllocator]::deallocate
:relfileprefix: ../../../
:mrdocs:

Return previously allocated memory to this allocator&period;

== Synopsis

Declared in `&lt;bsltf&lowbar;stdstatefulallocator&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void
deallocate(
    TYPE* address,
    xref:BloombergLP/bslma/Allocator/size_type.adoc[bslma::Allocator::size&lowbar;type] numElements);
----

== Description

Return memory previously allocated at the specified `address` for `numElements` back to this allocator&period; The `numElements` argument is ignored by this allocator type&period; The behavior is undefined unless `address` was allocated using this allocator object and has not already been deallocated&period;

== Parameters

[cols="1,4"]
|===
| Name| Description
| *address*
| memory previously returned by `allocate`
| *numElements*
| number of elements originally requested (ignored)
|===


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