Struct tlua::PushGuard

pub struct PushGuard<L>
where
    L: AsLua,
{ /* private fields */ }

RAII guard for a value pushed on the stack.

You shouldn’t have to manipulate this type directly unless you are fiddling with the library’s internals.

Implementations

impl<L: AsLua> PushGuard<L>

pub unsafe fn new(lua: L, size: i32) -> Self

Creates a new PushGuard from this Lua context representing size items on the stack. When this PushGuard is destroyed, size items will be popped.

Safety

There must be at least size elements on the lua stack and it must be safe to drop them at the same time with this PushGuard.

pub fn assert_one_and_forget(self) -> i32

pub fn size(&self) -> i32

Returns the number of elements managed by this PushGuard.

pub unsafe fn forget(self) -> i32

Prevents the value from being popped when the PushGuard is destroyed, and returns the number of elements on the Lua stack.

Safety

The values on the stack will not be popped automatically, so the caller must ensure nothing is leaked.

pub fn into_inner(self) -> L

Destroys the guard, popping the value. Returns the inner part, which returns access when using by-value capture.

Trait Implementations

impl<L> AsLua for PushGuard<L>

where L: AsLua,

fn as_lua(&self) -> *mut lua_State

fn try_push<T>( self, v: T ) -> Result<PushGuard<Self>, (<T as PushInto<Self>>::Err, Self)>

where Self: Sized, T: PushInto<Self>,

Try to push v onto the lua stack.

fn push<T>(self, v: T) -> PushGuard<Self>

where Self: Sized, T: PushInto<Self>, <T as PushInto<Self>>::Err: Into<Void>,

Push v onto the lua stack.

fn try_push_one<T>( self, v: T ) -> Result<PushGuard<Self>, (<T as PushInto<Self>>::Err, Self)>

where Self: Sized, T: PushOneInto<Self>,

Try to push v onto the lua stack.

fn push_one<T>(self, v: T) -> PushGuard<Self>

where Self: Sized, T: PushOneInto<Self>, <T as PushInto<Self>>::Err: Into<Void>,

Push v onto the lua stack.

fn push_iter<I>(self, iterator: I) -> Result<PushGuard<Self>, Self>

where Self: Sized, I: Iterator, <I as Iterator>::Item: PushInto<LuaState>, <<I as Iterator>::Item as PushInto<LuaState>>::Err: Into<Void>,

Push iterator onto the lua stack as a lua table.

fn try_push_iter<I>( self, iterator: I ) -> Result<PushGuard<Self>, (PushIterErrorOf<I>, Self)>

where Self: Sized, I: Iterator, <I as Iterator>::Item: PushInto<LuaState>,

Push iterator onto the lua stack as a lua table.

fn read<T>(self) -> ReadResult<T, Self>

where Self: Sized, T: LuaRead<Self>,

fn read_at<T>(self, index: i32) -> ReadResult<T, Self>

where Self: Sized, T: LuaRead<Self>,

fn read_at_nz<T>(self, index: NonZeroI32) -> ReadResult<T, Self>

where Self: Sized, T: LuaRead<Self>,

fn pcall<F, R>(&self, f: F) -> Result<R, LuaError>

where F: FnOnce(StaticLua) -> R,

Call a rust function in protected mode. If a lua error is thrown during execution of f the function will return a LuaError.

impl<L> Debug for PushGuard<L>

where L: AsLua + Debug,

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

Formats the value using the given formatter.

impl<L: AsLua> Drop for PushGuard<L>

fn drop(&mut self)

Executes the destructor for this type.