Struct RootScope 

pub struct RootScope<'a> { /* private fields */ }

A RAII frame that roots a set of GcRefs and optionally chains to a parent RootSet.

Roots are added via RootScope::root and dropped automatically when the scope ends. A scope keeps its own roots live; the collector also walks the parent chain, so a nested scope’s roots supplement (never replace) its ancestors’.

Implementations

impl<'a> RootScope<'a>

pub fn new() -> Self

A fresh top-level scope with no parent.

pub fn child(parent: &'a dyn RootSet) -> Self

A scope that chains onto parent; its roots are added to parent’s.

pub fn root(&mut self, gcref: GcRef) -> GcRef

Register gcref as a root for the lifetime of this scope and return a copy of it. The returned GcRef is kept alive until the scope drops.

Called for its rooting side-effect; the returned copy is a convenience for chaining.

pub fn root_count(&self) -> usize

Number of roots held directly by this scope (excluding the parent chain).

Trait Implementations

impl Default for RootScope<'_>

fn default() -> Self

Returns the “default value” for a type.

impl RootSet for RootScope<'_>

fn push_roots(&self, out: &mut Vec<GcRef>)

Push every root held by this set into out, in any order.