BloombergLP::bdlma::HeapBypassAllocator::allocate

Return a newly allocated buffer of the specified size bytes.

Synopsis

Declared in <bdlma_heapbypassallocator.h>

virtual
void*
allocate(bsls::Types::size_type size) override;

Description

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.

Return Value

address of the newly allocated buffer, or a null pointer if size is 0

Parameters

NameDescription
sizenumber of bytes to allocate