Enum allocator_suite::allocators::context_allocator::ContextAllocator

pub enum ContextAllocator<MS: MemorySource> {
    ShortLived(BumpAllocator<MS>),
    MediumLived(BitSetAllocator<MS>),
    LongLived(MultipleBinarySearchTreeAllocator<MS>),
}

An allocator designed for contexts with different lifetimes.

This allocator NEVER grows or shrinks its memory region.

This allocator is not thread-safe.

Variants

ShortLived(BumpAllocator<MS>)

Use this variant for contexts with short-lived lifetimes.

Very fast allocation and almost costless deallocation, at the expense of the strong likelihood of running out of memory.

Reallocation is very expensive when growing unless reallocating the most recently made allocation.

MediumLived(BitSetAllocator<MS>)

Use this variant for contexts with slightly longer than short-lived lifetimes.

Slower allocation and deallocation but reallocation is less expensive than for ShortLived.

LongLived(MultipleBinarySearchTreeAllocator<MS>)

Use this variant for contexts with long-lived lifetimes.

Trait Implementations

impl<MS: MemorySource> LocalAllocator for ContextAllocator<MS>

fn memory_range(&self) -> MemoryRange

The range of memory addresses that can be used to allocate memory by this allocator.

fn contains(&self, from_memory_address: MemoryAddress) -> bool

Returns true if this allocator is responsible for an allocation starting with the given from_memory_address.

impl<MS: MemorySource> Allocator for ContextAllocator<MS>

fn allocate(
    &self,
    non_zero_size: NonZeroUsize,
    non_zero_power_of_two_alignment: NonZeroUsize
) -> Result<MemoryAddress, AllocErr>

Allocate memory.

fn deallocate(
    &self,
    non_zero_size: NonZeroUsize,
    non_zero_power_of_two_alignment: NonZeroUsize,
    current_memory: MemoryAddress
)

Deallocate (free) memory.

fn growing_reallocate(
    &self,
    non_zero_new_size: NonZeroUsize,
    non_zero_power_of_two_alignment: NonZeroUsize,
    non_zero_current_size: NonZeroUsize,
    current_memory: MemoryAddress
) -> Result<MemoryAddress, AllocErr>

Reallocate memory by growing it.

fn shrinking_reallocate(
    &self,
    non_zero_new_size: NonZeroUsize,
    non_zero_power_of_two_alignment: NonZeroUsize,
    non_zero_current_size: NonZeroUsize,
    current_memory: MemoryAddress
) -> Result<MemoryAddress, AllocErr>

Reallocate memory by shrinking it.

const ZERO_SIZED_ALLOCATION: MemoryAddress

The sentinel value used for a zero-sized allocation.

fn adapt<'a>(&'a self) -> AllocatorAdaptor<'a, Self>

Adapts to a GlobalAlloc and Alloc.

fn adapt_reference<'a>(&'a self) -> &'a AllocatorAdaptor<'a, Self>

Adapts a reference to a GlobalAlloc and Alloc reference.

impl<MS: Debug + MemorySource> Debug for ContextAllocator<MS>

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

Formats the value using the given formatter.