Struct zub::vm::gc::Heap

pub struct Heap<T> { /* fields omitted */ }

Implementations

impl<T: Trace<T>> Heap<T>

pub fn new() -> Self

Create an empty heap.

pub fn insert_temp(&mut self, object: T) -> Handle<T>

Adds a new object to this heap that will be cleared upon the next garbage collection, if not attached to the object tree.

pub fn insert(&mut self, object: T) -> Rooted<T>

Adds a new object to this heap that will not be cleared by garbage collection until all rooted handles have been dropped.

pub fn make_rooted(&mut self, handle: impl AsRef<Handle<T>>) -> Rooted<T>

Upgrade a handle (that will be cleared by the garbage collector) into a rooted handle (that will not).

pub fn len(&self) -> usize

Count the number of heap-allocated objects in this heap

pub fn contains(&self, handle: impl AsRef<Handle<T>>) -> bool

Return true if the heap contains the specified handle

pub fn get(&self, handle: impl AsRef<Handle<T>>) -> Option<&T>

Get a reference to a heap object if it exists on this heap.

pub unsafe fn get_unchecked(&self, handle: impl AsRef<Handle<T>>) -> &T

Get a reference to a heap object without checking whether it is still alive or that it belongs to this heap.

If either invariant is not upheld, calling this function results in undefined behaviour.

pub fn get_mut(&mut self, handle: impl AsRef<Handle<T>>) -> Option<&mut T>

Get a mutable reference to a heap object

pub fn get_mut_unchecked(&mut self, handle: impl AsRef<Handle<T>>) -> &mut T

Get a mutable reference to a heap object without first checking that it is still alive or that it belongs to this heap.

If either invariant is not upheld, calling this function results in undefined behaviour. Provided they are upheld, this function provides zero-cost access.

pub fn clean_excluding(
    &mut self,
    excluding: impl IntoIterator<Item = Handle<T>>
)

pub fn clean(&mut self)

Clean orphaned objects from the heap.

Trait Implementations

impl<T: Clone> Clone for Heap<T>

fn clone(&self) -> Heap<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> Default for Heap<T>

fn default() -> Self

Returns the "default value" for a type.

impl<T> Drop for Heap<T>

fn drop(&mut self)

Executes the destructor for this type.