[#BloombergLP-bdlma-HeapBypassAllocator-allocate-0c]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlma.adoc[bdlma]::xref:BloombergLP/bdlma/HeapBypassAllocator.adoc[HeapBypassAllocator]::allocate
:relfileprefix: ../../../
:mrdocs:

Allocate a buffer of memory having the specified `size` (in bytes), and alignment defined by `bsls::AlignmentUtil::BSLS_MAX_ALIGNMENT`, from virtual memory. If `size` is 0, return a null pointer with no other effect. If this allocator cannot return the requested number of bytes, then it will throw a `std::bad_alloc` exception in an exception‐enabled build, or else will abort the program in a non‐ exception build. The behavior is undefined unless `0 <= size`.

== Synopsis

Declared in `<bdlma_heapbypassallocator.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
virtual
void*
allocate(xref:BloombergLP/bsls/Types/size_type.adoc[bsls::Types::size_type] size) override;
----


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