Struct MetatableBuilder 

pub struct MetatableBuilder<'vm, T> { /* private fields */ }

Concrete builder that emits a Gc<Table> metatable for T. Created internally by Vm::register_userdata; embedders never name this type.

Trait Implementations

impl<'vm, T: LuaUserdata> UserdataMethods<T> for MetatableBuilder<'vm, T>

fn add_method<F, A, R>(&mut self, name: &str, f: F)

where F: Fn(&mut Vm, &T, A) -> Result<R, LuaError> + Copy + 'static, A: FromLuaArgs + 'static, R: IntoLuaReturn + 'static,

Register a regular method bound to __index[name] on the generated metatable; method lookup u:name(args) resolves through Lua’s normal __index table dispatch.

fn add_method_mut<F, A, R>(&mut self, name: &str, f: F)

where F: Fn(&mut Vm, &mut T, A) -> Result<R, LuaError> + Copy + 'static, A: FromLuaArgs + 'static, R: IntoLuaReturn + 'static,

Mutable variant of add_method. The &mut T borrow is exclusive within the call window; an embedder must not concurrently userdata_borrow_mut the same payload through another path during the method body.

fn add_function<F, A, R>(&mut self, name: &str, f: F)

where F: Fn(&mut Vm, A) -> Result<R, LuaError> + Copy + 'static, A: FromLuaArgs + 'static, R: IntoLuaReturn + 'static,

Register a static-style function (no implicit receiver). Bound directly on the metatable, not under __index, so it is reachable as Vec3.new(...) after vm.set_global("Vec3", mt).

fn add_meta_method<F, A, R>(&mut self, meta: MetaMethod, f: F)

where F: Fn(&mut Vm, &T, A) -> Result<R, LuaError> + Copy + 'static, A: FromLuaArgs + 'static, R: IntoLuaReturn + 'static,

Register a metamethod (__add / __tostring / …). Stored directly on the metatable; the dispatcher’s existing get_mm path resolves it.

fn add_meta_method_mut<F, A, R>(&mut self, meta: MetaMethod, f: F)

where F: Fn(&mut Vm, &mut T, A) -> Result<R, LuaError> + Copy + 'static, A: FromLuaArgs + 'static, R: IntoLuaReturn + 'static,

Mutable variant of add_meta_method.

fn add_field_method_get<F, R>(&mut self, name: &str, f: F)

where F: Fn(&mut Vm, &T) -> Result<R, LuaError> + Copy + 'static, R: IntoLuaReturn + 'static,

Field-getter sugar: equivalent to add_method with no args and a single-value return.

fn add_field_method_set<F, A>(&mut self, name: &str, f: F)

where F: Fn(&mut Vm, &mut T, A) -> Result<(), LuaError> + Copy + 'static, A: FromLuaArgs + 'static,

Field-setter sugar: registers a setter for obj.name = value (v1.3 UD1). When any add_field_method_set is registered, MetatableBuilder installs a __newindex trampoline that dispatches (self, value) to the registered setter. Unknown fields raise a runtime error rather than silently dropping the write (matches code/no-unsolicited-fallback).