Struct Gc 

pub struct Gc<T> { /* private fields */ }

Copy handle to a heap-allocated GC-managed object. Layout is a single NonNull<T>; the GC walks reachability via root scanning and intrusive linkage on GcHeader, not via reference counts.

Implementations

impl<T> Gc<T>

pub fn as_ptr(self) -> *mut T

Raw pointer to the referent. Always non-null; valid for the lifetime of the Heap that allocated it as long as the object is reachable.

pub fn ptr_eq(self, other: Gc<T>) -> bool

Pointer-identity equality (PUC rawequal for reference types).

impl Gc<LuaStr>

Inline-bytes access MUST go through a pointer carrying the provenance of the original allocation — a &LuaStr only covers the header, so deriving the tail from it is UB (caught by miri). Gc stores the allocation pointer, hence these live on Gc<LuaStr>.

pub fn as_bytes(&self) -> &[u8]

Borrow the underlying bytes of this Lua string.

pub fn hash(&self) -> u32

Cached hash of the string (computed lazily for long strings).

Trait Implementations

impl<T> Clone for Gc<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T> Copy for Gc<T>

impl<T> Debug for Gc<T>

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

Formats the value using the given formatter.

impl<T> Deref for Gc<T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &T

Dereferences the value.

impl IntoValue for Gc<Table>

fn into_value(self, _vm: &mut Vm) -> Value

Convert self to a Lua Value, interning strings or allocating other GC-managed types via vm.heap as needed.

impl IntoValue for Gc<LuaClosure>

fn into_value(self, _vm: &mut Vm) -> Value

Convert self to a Lua Value, interning strings or allocating other GC-managed types via vm.heap as needed.

impl IntoValue for Gc<NativeClosure>

fn into_value(self, _vm: &mut Vm) -> Value

Convert self to a Lua Value, interning strings or allocating other GC-managed types via vm.heap as needed.