BloombergLP::bslma::SequentialAllocator::expand

Expand the memory block at the specified address up to maxNumBytes.

Synopsis

Declared in <bslma_sequentialallocator.h>

int
expand(
    void* address,
    int originalNumBytes,
    int maxNumBytes);

Description

Increase the amount of memory allocated at the specified address from the specified originalNumBytes to the maximum amount easily obtainable up to the specified maxNumBytes. Return the amount of memory available at address after the expansion. The behavior is undefined unless the call to this allocator that provided the address was performed with the originalNumBytes and originalNumBytes < maxNumBytes. Note that this function will not expand the memory unless there have been no allocations since the allocation for originalNumBytes.

Return Value

The amount of memory available after expansion (in bytes).

Parameters

Name

Description

address

The address of the memory block to expand.

originalNumBytes

The original allocation size (in bytes).

maxNumBytes

The maximum expanded size (in bytes).

Created with MrDocs