Struct HeapGuard 

pub struct HeapGuard { /* private fields */ }

A scoped guard for the currently-active heap. Pushed at entry to state.run() / state.protected_call() / state.load(); popped on drop. Supports nesting (multiple LuaStates on one thread).

Holds a strong Rc<Heap> on the TLS stack (issue #252): the guard is sound with no outlives contract — a guard that outlives its Lua keeps the heap alive until the guard pops, rather than dangling. Guards are function-scoped everywhere in-tree, so the lifetime extension is transient by construction.

!Send/!Sync (via the Rc it carries): the stack it pops lives in this thread’s TLS, so moving a guard to another thread would pop the wrong stack. The guard keeps its own copy of the heap handle so Drop can assert it pops the frame it pushed.

Implementations

impl HeapGuard

pub fn push(heap: &Rc<Heap>) -> Self

Push heap onto the active stack. Returns a guard; dropping it pops.

Trait Implementations

impl Drop for HeapGuard

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.