[#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.

== Synopsis

Declared in `<bsltf_stdstatefulallocator.h>`

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

== Description

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

== 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]#