Struct ObjectStore 

pub struct ObjectStore { /* private fields */ }

Thread-local storage for heap objects.

Uses a Vec<Option<HeapObject>> with a free-list for O(1) alloc/free. A production implementation could use mmap’d regions for large heaps, but the current design is correct and suitable for the interpreter.

Implementations

impl ObjectStore

pub fn new() -> Self

Create a new empty object store.

pub fn with_capacity(cap: usize) -> Self

Create a new object store with pre-allocated capacity.

pub fn allocate(&mut self, obj: HeapObject) -> usize

Allocate a new heap object and return its ID.

pub fn deallocate(&mut self, id: usize) -> Option<HeapObject>

Deallocate a heap object by ID.

pub fn get(&self, id: usize) -> Option<&HeapObject>

Get a reference to a heap object by ID.

pub fn get_mut(&mut self, id: usize) -> Option<&mut HeapObject>

Get a mutable reference to a heap object by ID.

pub fn stats(&self) -> &AllocationStats

Get allocation statistics.

pub fn live_count(&self) -> usize

Number of live objects.

pub fn capacity(&self) -> usize

Total capacity (including free slots).

Trait Implementations

impl Default for ObjectStore

fn default() -> Self

Returns the “default value” for a type.