Struct ArenaAllocator 

pub struct ArenaAllocator<S: MemoryDescriptor> { /* private fields */ }

Arena allocator backed by an instance of a MemoryDescriptor object.

This struct wraps an Allocator from the offset_allocator crate, and provides methods for allocating memory from the storage.

The allocator is thread-safe, and the storage is shared between the allocator and the buffers.

Implementations

impl<S: MemoryDescriptor> ArenaAllocator<S>

pub fn new(storage: S, page_size: usize) -> Result<Self, ArenaError>

Create a new ArenaAllocator from a MemoryDescriptor object and a page size.

The page size must be a power of two.

The allocator will divide the storage into pages and allocations will consist of a set of contiguous pages whose aggregate size is greater than or equal to the requested size.

The allocator is thread-safe, and the storage is shared between the allocator and the buffers.

pub fn allocate(&self, size: usize) -> Result<ArenaBuffer<S>, ArenaError>

Allocates a new ArenaBuffer of the given size from this allocator.

The actual allocation may consume more pages than strictly needed due to page-size rounding. Returns ArenaError::AllocationFailed if there are not enough contiguous pages available.

Trait Implementations

impl<S: Clone + MemoryDescriptor> Clone for ArenaAllocator<S>

fn clone(&self) -> ArenaAllocator<S>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<S: MemoryDescriptor> Debug for ArenaAllocator<S>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.