Struct bones_framework::prelude::piccolo::thread::Executor
pub struct Executor<'gc>(/* private fields */);
Expand description
The entry-point for the Lua VM.
Executor
runs networks of Threads
that may depend on each other and may pass control
back and forth. All Lua code that is run is done so directly or indirectly by calling
Executor::step
.
§Panics
Executor
is dangerous to use from within any kind of Lua callback. It has no protection
against re-entrency, and calling Executor
methods from within a callback that it is running
(other than Executor::mode
) will panic. Additionally, even if an independent Executor
is
used, cross-thread upvalues may cause a panic if one Executor
is used within the other.
Executor
s are not meant to be used from callbacks at all, and Executor
s should not be
nested. Instead, use the normal mechanisms for callbacks to call Lua code so that it is run on
the same executor calling the callback.
Implementations§
§impl<'gc> Executor<'gc>
impl<'gc> Executor<'gc>
pub fn run(mc: &Mutation<'gc>, thread: Thread<'gc>) -> Executor<'gc>
pub fn run(mc: &Mutation<'gc>, thread: Thread<'gc>) -> Executor<'gc>
Creates a new Executor
that begins running the given thread.
pub fn from_inner(inner: Gc<'gc, RefLock<ExecutorState<'gc>>>) -> Executor<'gc>
pub fn into_inner(self) -> Gc<'gc, RefLock<ExecutorState<'gc>>>
pub fn start(
ctx: Context<'gc>,
function: Function<'gc>,
args: impl IntoMultiValue<'gc>,
) -> Executor<'gc>
pub fn start( ctx: Context<'gc>, function: Function<'gc>, args: impl IntoMultiValue<'gc>, ) -> Executor<'gc>
Creates a new Executor
with a new Thread
running the given function.
pub fn mode(self) -> ExecutorMode
pub fn step(self, ctx: Context<'gc>, fuel: &mut Fuel) -> bool
pub fn step(self, ctx: Context<'gc>, fuel: &mut Fuel) -> bool
Runs the VM for a period of time controlled by the fuel
parameter.
The VM and callbacks will consume fuel as they run, and Executor::step
will return as soon
as Fuel::can_continue()
returns false and some minimal positive progress has been made.
Returns false
if the method has exhausted its fuel, but there is more work to
do, and returns true
if no more progress can be made. If true
is returned, then
Executor::mode()
will no longer be ExecutorMode::Normal
.
pub fn take_result<T>(
self,
ctx: Context<'gc>,
) -> Result<Result<T, Error<'gc>>, BadExecutorMode>where
T: FromMultiValue<'gc>,
pub fn resume( self, ctx: Context<'gc>, args: impl IntoMultiValue<'gc>, ) -> Result<(), BadExecutorMode>
pub fn resume_err( self, mc: &Mutation<'gc>, error: Error<'gc>, ) -> Result<(), BadExecutorMode>
pub fn stop(self, mc: &Mutation<'gc>)
pub fn stop(self, mc: &Mutation<'gc>)
Reset this Executor
entirely, leaving it with a stopped main thread. Equivalent to
creating a new executor with Executor::new
.
pub fn reset(self, mc: &Mutation<'gc>, thread: Thread<'gc>)
pub fn reset(self, mc: &Mutation<'gc>, thread: Thread<'gc>)
Reset this Executor
entirely and begins running the given thread. Equivalent to
creating a new executor with Executor::run
.
pub fn restart(
self,
ctx: Context<'gc>,
function: Function<'gc>,
args: impl IntoMultiValue<'gc>,
)
pub fn restart( self, ctx: Context<'gc>, function: Function<'gc>, args: impl IntoMultiValue<'gc>, )
Reset this Executor
entirely and begins running the given function, equivalent to
creating a new executor with Executor::start
.
Trait Implementations§
§impl<'gc> Collect for Executor<'gc>
impl<'gc> Collect for Executor<'gc>
§fn needs_trace() -> bool
fn needs_trace() -> bool
Gc
pointer and trace
is unnecessary
to call, you may implement this method and return false. The default implementation returns
true, signaling that Collect::trace
must be called.§impl<'gc> PartialEq for Executor<'gc>
impl<'gc> PartialEq for Executor<'gc>
impl<'gc> Copy for Executor<'gc>
impl<'gc> Eq for Executor<'gc>
Auto Trait Implementations§
impl<'gc> Freeze for Executor<'gc>
impl<'gc> !RefUnwindSafe for Executor<'gc>
impl<'gc> !Send for Executor<'gc>
impl<'gc> !Sync for Executor<'gc>
impl<'gc> Unpin for Executor<'gc>
impl<'gc> !UnwindSafe for Executor<'gc>
Blanket Implementations§
§impl<T> AnyEq for T
impl<T> AnyEq for T
§impl<'a, T, E> AsTaggedExplicit<'a, E> for Twhere
T: 'a,
impl<'a, T, E> AsTaggedExplicit<'a, E> for Twhere
T: 'a,
§impl<'a, T, E> AsTaggedImplicit<'a, E> for Twhere
T: 'a,
impl<'a, T, E> AsTaggedImplicit<'a, E> for Twhere
T: 'a,
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> CloneToUninit for Twhere
T: Copy,
impl<T> CloneToUninit for Twhere
T: Copy,
source§unsafe fn clone_to_uninit(&self, dst: *mut T)
unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
source§default unsafe fn clone_to_uninit(&self, dst: *mut T)
default unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)§impl<T> Conv for T
impl<T> Conv for T
§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
fn equivalent(&self, key: &K) -> bool
§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key
and return true
if they are equal.§impl<T> FmtForward for T
impl<T> FmtForward for T
§fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
self
to use its Binary
implementation when Debug
-formatted.§fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
self
to use its Display
implementation when
Debug
-formatted.§fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
self
to use its LowerExp
implementation when
Debug
-formatted.§fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
self
to use its LowerHex
implementation when
Debug
-formatted.§fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
self
to use its Octal
implementation when Debug
-formatted.§fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
self
to use its Pointer
implementation when
Debug
-formatted.§fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
self
to use its UpperExp
implementation when
Debug
-formatted.§fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
self
to use its UpperHex
implementation when
Debug
-formatted.§fn fmt_list(self) -> FmtList<Self>where
&'a Self: for<'a> IntoIterator,
fn fmt_list(self) -> FmtList<Self>where
&'a Self: for<'a> IntoIterator,
§impl<S> FromSample<S> for S
impl<S> FromSample<S> for S
fn from_sample_(s: S) -> S
§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
§impl<F, T> IntoSample<T> for Fwhere
T: FromSample<F>,
impl<F, T> IntoSample<T> for Fwhere
T: FromSample<F>,
fn into_sample(self) -> T
§impl<T> Pipe for Twhere
T: ?Sized,
impl<T> Pipe for Twhere
T: ?Sized,
§fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
§fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
self
and passes that borrow into the pipe function. Read more§fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
self
and passes that borrow into the pipe function. Read more§fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
§fn pipe_borrow_mut<'a, B, R>(
&'a mut self,
func: impl FnOnce(&'a mut B) -> R,
) -> R
fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R, ) -> R
§fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
self
, then passes self.as_ref()
into the pipe function.§fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
self
, then passes self.as_mut()
into the pipe
function.§fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
self
, then passes self.deref()
into the pipe function.§impl<T> Tap for T
impl<T> Tap for T
§fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
Borrow<B>
of a value. Read more§fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
BorrowMut<B>
of a value. Read more§fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
AsRef<R>
view of a value. Read more§fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
AsMut<R>
view of a value. Read more§fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
Deref::Target
of a value. Read more§fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
Deref::Target
of a value. Read more§fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
.tap()
only in debug builds, and is erased in release builds.§fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
.tap_mut()
only in debug builds, and is erased in release
builds.§fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
.tap_borrow()
only in debug builds, and is erased in release
builds.§fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
.tap_borrow_mut()
only in debug builds, and is erased in release
builds.§fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
.tap_ref()
only in debug builds, and is erased in release
builds.§fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
.tap_ref_mut()
only in debug builds, and is erased in release
builds.§fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
.tap_deref()
only in debug builds, and is erased in release
builds.