Struct SpawnToken

pub struct SpawnToken<S> { /* private fields */ }

Token to spawn a newly-created task in an executor.

When calling a task function (like #[embassy_executor::task] async fn my_task() { ... }), the returned value is a SpawnToken that represents an instance of the task, ready to spawn. You must then spawn it into an executor, typically with Spawner::spawn().

The generic parameter S determines whether the task can be spawned in executors in other threads or not. If S: Send, it can, which allows spawning it into a SendSpawner. If not, it can’t, so it can only be spawned into the current thread’s executor, with Spawner.

Panics

Dropping a SpawnToken instance panics. You may not “abort” spawning a task in this way. Once you’ve invoked a task function and obtained a SpawnToken, you must spawn it.

Implementations

impl<S> SpawnToken<S>

pub fn id(&self) -> u32

Returns the task id if available, otherwise 0 This can be used in combination with rtos-trace to match task names with id’s

pub fn new_failed() -> Self

Return a SpawnToken that represents a failed spawn.

Trait Implementations

impl<S> Drop for SpawnToken<S>

fn drop(&mut self)

Executes the destructor for this type.