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

Allocate enough (properly aligned) space for the specified `numElements` of the (template parameter) type `TYPE`&period; If the underlying `bslma&colon;&colon;Allocator` is unable to fulfill the allocation request, an exception (typically `bsl&colon;&colon;bad&lowbar;alloc`) will be thrown&period;

== Synopsis

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

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


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