pub struct ThreadExecutor<'task> { /* private fields */ }
Expand description

An executor that can only be ticked on the thread it was instantiated on. But can spawn Send tasks from other threads.

Example

use bevy_tasks::ThreadExecutor;

let thread_executor = ThreadExecutor::new();
let count = Arc::new(AtomicI32::new(0));

// create some owned values that can be moved into another thread
let count_clone = count.clone();

std::thread::scope(|scope| {
    scope.spawn(|| {
        // we cannot get the ticker from another thread
        let not_thread_ticker = thread_executor.ticker();
        assert!(not_thread_ticker.is_none());
         
        // but we can spawn tasks from another thread
        thread_executor.spawn(async move {
            count_clone.fetch_add(1, Ordering::Relaxed);
        }).detach();
    });
});

// the tasks do not make progress unless the executor is manually ticked
assert_eq!(count.load(Ordering::Relaxed), 0);

// tick the ticker until task finishes
let thread_ticker = thread_executor.ticker().unwrap();
thread_ticker.try_tick();
assert_eq!(count.load(Ordering::Relaxed), 1);

Implementations§

source§

impl<'task> ThreadExecutor<'task>

source

pub fn new() -> ThreadExecutor<'task>

create a new ThreadExecutor

source

pub fn spawn<T>( &self, future: impl Future<Output = T> + Send + 'task ) -> Task<T>
where T: Send + 'task,

Spawn a task on the thread executor

source

pub fn ticker<'ticker>( &'ticker self ) -> Option<ThreadExecutorTicker<'task, 'ticker>>

Gets the ThreadExecutorTicker for this executor. Use this to tick the executor. It only returns the ticker if it’s on the thread the executor was created on and returns None otherwise.

source

pub fn is_same(&self, other: &ThreadExecutor<'task>) -> bool

Returns true if self and other’s executor is same

Trait Implementations§

source§

impl<'task> Debug for ThreadExecutor<'task>

source§

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

Formats the value using the given formatter. Read more
source§

impl<'task> Default for ThreadExecutor<'task>

source§

fn default() -> ThreadExecutor<'task>

Returns the “default value” for a type. Read more

Auto Trait Implementations§

§

impl<'task> RefUnwindSafe for ThreadExecutor<'task>

§

impl<'task> Send for ThreadExecutor<'task>

§

impl<'task> Sync for ThreadExecutor<'task>

§

impl<'task> Unpin for ThreadExecutor<'task>

§

impl<'task> UnwindSafe for ThreadExecutor<'task>

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T, U> AsBindGroupShaderType<U> for T
where U: ShaderType, &'a T: for<'a> Into<U>,

source§

fn as_bind_group_shader_type(&self, _images: &RenderAssets<Image>) -> U

Return the T ShaderType for self. When used in AsBindGroup derives, it is safe to assume that all images in self exist.
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> Downcast<T> for T

source§

fn downcast(&self) -> &T

source§

impl<T> Downcast for T
where T: Any,

source§

fn into_any(self: Box<T>) -> Box<dyn Any>

Convert Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>. Box<dyn Any> can then be further downcast into Box<ConcreteType> where ConcreteType implements Trait.
source§

fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>

Convert Rc<Trait> (where Trait: Downcast) to Rc<Any>. Rc<Any> can then be further downcast into Rc<ConcreteType> where ConcreteType implements Trait.
source§

fn as_any(&self) -> &(dyn Any + 'static)

Convert &Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &Any’s vtable from &Trait’s.
source§

fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)

Convert &mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &mut Any’s vtable from &mut Trait’s.
source§

impl<T> DowncastSync for T
where T: Any + Send + Sync,

source§

fn into_any_arc(self: Arc<T>) -> Arc<dyn Any + Send + Sync>

Convert Arc<Trait> (where Trait: Downcast) to Arc<Any>. Arc<Any> can then be further downcast into Arc<ConcreteType> where ConcreteType implements Trait.
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<S> FromSample<S> for S

source§

fn from_sample_(s: S) -> S

source§

impl<T> FromWorld for T
where T: Default,

source§

fn from_world(_world: &mut World) -> T

Creates Self using data from the given World.
source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T, U> ToSample<U> for T
where U: FromSample<T>,

source§

fn to_sample_(self) -> U

source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<T> Upcast<T> for T

source§

fn upcast(&self) -> Option<&T>

source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

impl<S, T> Duplex<S> for T
where T: FromSample<S> + ToSample<S>,

source§

impl<T> Settings for T
where T: 'static + Send + Sync,

source§

impl<T> WasmNotSend for T
where T: Send,

source§

impl<T> WasmNotSendSync for T

source§

impl<T> WasmNotSync for T
where T: Sync,