Struct embassy_executor::Spawner
source · 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
impl Spawner
sourcepub async fn for_current_executor() -> Self
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.
sourcepub fn spawn<S>(&self, token: SpawnToken<S>) -> Result<(), SpawnError>
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]
).
sourcepub fn must_spawn<S>(&self, token: SpawnToken<S>)
pub fn must_spawn<S>(&self, token: SpawnToken<S>)
sourcepub fn make_send(&self) -> SendSpawner
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.