Struct Array

pub struct Array<const N: usize> { /* private fields */ }

An allocator that hands out allocations from a statically-sized chunk of bytes.

If the memory is exhausted, the only way to obtain more is to free all existing allocations. Alternatively, you can layer another allocator on top of this one that uses a more sophisticated allocation strategy.

Implementations

impl<const N: usize> Array<N>

pub fn new() -> Self

Create a new, empty array allocator.

Note that the internal buffer is uninitialized. This does not matter, since memory allocated via the Allocator interface has no guarantees about initialization.

Trait Implementations

impl<const N: usize> Allocator for Array<N>

fn brand(&self) -> &Brand

The unique brand of this allocator, that prevents allocations from other allocators from being freed in this one, and vice-versa.

fn alloc_bytes(&self, layout: Layout) -> Result<Alloc<'_, u8>, Error>

Create an allocation of a certain layout, treating it as bytes.

fn dealloc_bytes<'this>(&'this self, alloc: Alloc<'this, u8>)

Free an allocation.

fn dangling(&self, align: Align) -> Alloc<'_, u8>

Returns a zero-sized allocation.

fn total_size(&self) -> Option<usize>

The total size available to be allocated.

fn remaining_size(&self) -> Option<usize>

The remaining amount of memory available to be allocated.

fn alloc_zeroed(&self, layout: Layout) -> Result<Alloc<'_, u8>, Error>

Like alloc_bytes, but guarantees that it is filled with zeroes.

fn realloc<'this>( &'this self, alloc: Alloc<'this, u8>, layout: Layout, ) -> Result<Alloc<'this, u8>, Error>

Transform a given allocation to a new layout (generally to grow/shrink it).

fn grow<'this>( &'this self, alloc: Alloc<'this, u8>, layout: Layout, ) -> Result<Alloc<'this, u8>, Error>

Transform a given allocation to a new layout (generally to grow it). Copies previous data into the first bytes of the new allocation, with the remaining bytes uninitialized.

fn shrink<'this>( &'this self, alloc: Alloc<'this, u8>, layout: Layout, ) -> Result<Alloc<'this, u8>, Error>

Transform a given allocation to a new layout (generally to shrink it). Copies over as much data from the original allocation as will fit.

impl<const N: usize> Default for Array<N>

fn default() -> Self

Returns the “default value” for a type.

impl<const N: usize> Sync for Array<N>