Struct Chunk 

pub struct Chunk { /* private fields */ }

A wholesale block of memory obtained via direct_alloc out of which the MemoryPool carves the *mut u8 slots handed to consumers.

A Chunk serves allocations in two ways.

1. Reusing a deallocated section tracked in its FreeList (after defragmenting it).
2. Bumping the internal cursor over the untouched tail of the block.

The backing block is released via direct_dealloc when the Chunk is dropped.

Implementations

impl Chunk

pub fn new(capacity: usize) -> Option<Chunk>

Allocates a new Chunk of capacity bytes using direct_alloc.

Returns None if the system refuses to hand us the memory.

pub fn capacity(&self) -> usize

pub fn remaining(&self) -> usize

Number of bytes remaining in the untouched tail of the Chunk.

pub fn contains(&self, ptr: *const u8) -> bool

Checks if ptr points into the memory block owned by this Chunk.

pub fn can_allocate(&self, size: usize, align: usize) -> bool

Checks if this Chunk has a slot of size bytes aligned to align available, either in its FreeList or in its untouched tail. Call Self::defragment first for best results.

pub fn defragment(&mut self)

Merges adjacent FreeSlot entries back into single continuous sections.

Because the FreeList is kept sorted by address, a single pass suffices. Merging maximizes the odds that a deallocated region can be recycled for a new allocation.

pub fn allocate(&mut self, size: usize, align: usize) -> Option<*mut u8>

Obtains a *mut u8 slot of size bytes aligned to align from this Chunk.

Order of Operations

1. Defragment the FreeList via Self::defragment.
2. Try to recycle a deallocated section via Self::reclaim.
3. Fall back to bumping the cursor over the untouched tail via Self::bump.

Returns None if no slot is available in this Chunk.

pub fn deallocate(&mut self, ptr: *mut u8, size: usize)

Returns a slot to this Chunk by recording it in the FreeList so a later allocation can recycle it. No memory is returned to the system here.

Trait Implementations

impl Debug for Chunk

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

Formats the value using the given formatter.

impl Drop for Chunk

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.