This class implements a low‐level memory manager that allocates and manages a sequence of memory blocks ‐‐ each potentially of a different size as specified during the invocation of the allocate method. Allocated blocks may be efficiently deallocated individually, i.e., potentially in constant time depending on the supplied allocator. The release method deallocates the entire sequence of memory blocks, as does the destructor.

Synopsis

Declared in <bdlma_blocklist.h>

class BlockList;

Member Functions

Name

Description

BlockList [constructor]

Create an empty block list suitable for managing memory blocks of varying sizes. Optionally specify a basicAllocator used to supply memory. If basicAllocator is 0, the currently installed default allocator is used.

~BlockList [destructor]

Destroy this object and deallocate all outstanding memory blocks managed by this object.

allocate

Return the address of a contiguous block of memory of the specified size (in bytes). If size is 0, no memory is allocated and 0 is returned. The returned memory is guaranteed to be maximally aligned.

allocator

Return the allocator used by this object to allocate memory.

deallocate

Return the memory at the specified address back to the associated allocator. If address is 0, this function has no effect. The behavior is undefined unless address was allocated by this object, and has not already been deallocated.

release

Deallocate all memory blocks currently managed by this object, returning it to its default‐constructed state.

Created with MrDocs