pub struct LuaThread<'lua>(/* private fields */);
Expand description
Handle to an internal Lua thread (coroutine).
Implementations§
source§impl<'lua> Thread<'lua>
impl<'lua> Thread<'lua>
sourcepub fn resume<A, R>(&self, args: A) -> Result<R, Error>where
A: IntoLuaMulti<'lua>,
R: FromLuaMulti<'lua>,
pub fn resume<A, R>(&self, args: A) -> Result<R, Error>where
A: IntoLuaMulti<'lua>,
R: FromLuaMulti<'lua>,
Resumes execution of this thread.
Equivalent to coroutine.resume
.
Passes args
as arguments to the thread. If the coroutine has called coroutine.yield
, it
will return these arguments. Otherwise, the coroutine wasn’t yet started, so the arguments
are passed to its main function.
If the thread is no longer in Active
state (meaning it has finished execution or
encountered an error), this will return Err(CoroutineInactive)
, otherwise will return Ok
as follows:
If the thread calls coroutine.yield
, returns the values passed to yield
. If the thread
return
s values from its main function, returns those.
§Examples
let thread: Thread = lua.load(r#"
coroutine.create(function(arg)
assert(arg == 42)
local yieldarg = coroutine.yield(123)
assert(yieldarg == 43)
return 987
end)
"#).eval()?;
assert_eq!(thread.resume::<_, u32>(42)?, 123);
assert_eq!(thread.resume::<_, u32>(43)?, 987);
// The coroutine has now returned, so `resume` will fail
match thread.resume::<_, u32>(()) {
Err(Error::CoroutineInactive) => {},
unexpected => panic!("unexpected result {:?}", unexpected),
}
sourcepub fn status(&self) -> ThreadStatus
pub fn status(&self) -> ThreadStatus
Gets the status of the thread.
sourcepub fn set_hook<F>(&self, triggers: HookTriggers, callback: F)
pub fn set_hook<F>(&self, triggers: HookTriggers, callback: F)
Sets a ‘hook’ function that will periodically be called as Lua code executes.
This function is similar or Lua::set_hook()
except that it sets for the thread.
To remove a hook call Lua::remove_hook()
.
sourcepub fn reset(&self, func: Function<'lua>) -> Result<(), Error>
pub fn reset(&self, func: Function<'lua>) -> Result<(), Error>
Resets a thread
In Lua 5.4: cleans its call stack and closes all pending to-be-closed variables. Returns a error in case of either the original error that stopped the thread or errors in closing methods.
In Luau: resets to the initial state of a newly created Lua thread. Lua threads in arbitrary states (like yielded or errored) can be reset properly.
Sets a Lua function for the thread afterwards.
Requires feature = "lua54"
OR feature = "luau"
.