pub struct Spawner { /* private fields */ }
Expand description

生成任务到执行器中的句柄

这个生成器可以生成任何任务(无论任务是否 Send),但是它只能在它执行器所在的线程中使用(它自己本身非 Send)

如果你想在另一个线程中生成任务,请使用 SendSpawner


Handle to spawn tasks into an executor.

This Spawner can spawn any task (Send and non-Send ones), but it can only be used in the executor thread (it is not Send itself).

If you want to spawn tasks from another thread, use SendSpawner.

Implementations§

source§

impl Spawner

source

pub async fn for_current_executor() -> Self

从当前执行器中获取生成器

这个函数是 async 的,仅是为了访问当前异步上下文。它会立即返回,不会阻塞。

#异常 如果当前执行器不是的 Embassy 执行器就会发生异常。


Get a Spawner for the current executor.

This function is async just to get access to the current async context. It returns instantly, it does not block/yield.

Panics

Panics if the current executor is not an Embassy executor.

source

pub fn spawn<S>(&self, token: SpawnToken<S>) -> Result<(), SpawnError>

创建一个任务到执行器中

你可以调用任务函数来获取token(比如一个被#[embassy_executor::task]标记的函数)


Spawn a task into an executor.

You obtain the token by calling a task function (i.e. one marked with #[embassy_executor::task]).

source

pub fn must_spawn<S>(&self, token: SpawnToken<S>)

创建一个任务到执行器中,失败时会发生异常。

异常

如果创建失败就会异常


Spawn a task into an executor, panicking on failure.

Panics

Panics if the spawning fails.

source

pub fn make_send(&self) -> SendSpawner

将当前 Spawner 转换为 SendSpawner。这样就可以将生成器发送到其他线程, 但是这个 spawner 会就只能生成 Send 的任务。


Convert this Spawner to a SendSpawner. This allows you to send the spawner to other threads, but the spawner loses the ability to spawn non-Send tasks.

Trait Implementations§

source§

impl Clone for Spawner

source§

fn clone(&self) -> Spawner

Returns a copy of the value. Read more
1.0.0 · source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
source§

impl Copy for Spawner

Auto Trait Implementations§

Blanket Implementations§

source§

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

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

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

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

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

source§

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

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for Twhere 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> ToOwned for Twhere T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for Twhere 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 Twhere 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.