Struct TableBuilder 

pub struct TableBuilder<'vm> { /* private fields */ }

Multi-step table construction. Borrows &mut Vm for the whole builder window so no other Vm operation can interleave (which might trigger GC mid-build). Consume with TableBuilder::build.

Implementations

impl<'vm> TableBuilder<'vm>

pub fn with<K, V>(self, k: K, v: V) -> Self

where K: IntoValue, V: IntoValue,

Add a (key, value) entry. Both may be any IntoValue. Panics if the table overflows (MAX_ASIZE = 1<<27; unreachable in practice — embedders building tables that large have other problems).

pub fn try_with<K, V>(self, k: K, v: V) -> Result<Self, LuaError>

where K: IntoValue, V: IntoValue,

Fallible variant of TableBuilder::with — propagates TableError::Overflow as LuaError instead of panicking.

pub fn build(self) -> Gc<Table>

Finalize: emit a GC write barrier (so any newly-rooted children are visible to the collector) and return the table handle.