Allocate a memory block of the specified size from buffer.

Synopsis

Declared in <bslma_bufferallocator.h>

static
void*
allocateFromBuffer(
    int* cursor,
    char* buffer,
    size_type bufSize,
    size_type size,
    AlignmentStrategy strategy);

Description

Allocate a memory block of the specified size from the specified buffer at the specified cursor position. Return the address of the allocated memory block if buffer contains enough available memory, and null otherwise. The cursor is set to the index of the next available byte in buffer after the allocation. Use the specified alignment strategy (or alignment value) to allocate memory. If size is 0, do not allocate memory and return zero. The behavior is undefined unless 0 < = bufSize, 0 <= size, 0 < alignment <= bsls::AlignmentUtil::BSLS_MAX_ALIGNMENT, and alignment is an integral power of 2.

Return Value

address of the allocated block, or null if insufficient space

Parameters

Name

Description

cursor

Index of the next available byte in buffer (in/out).

buffer

Memory buffer from which to allocate.

bufSize

Size (in bytes) of buffer.

size

Number of bytes to allocate.

strategy

Alignment strategy used for the allocation.

Created with MrDocs