Struct Task 

pub struct Task;

A task is a lightweight thread of execution designed to run one particular action.

Tasks can not receive messages from other processes, only send.

Calls that are allowed:

• Process::send
• GenServer::cast

Calls that would panic:

• Process::link
• Process::monitor
• GenServer::call

You can however return a value in a task and await it to receive the value.

It’s not recommended to await long running tasks in a GenServer since it will delay processing of other messages. Instead, you should send a cast with the result of your task and handle it in handle_cast.

Implementations

impl Task

pub fn spawn<F>(task: F) -> TaskHandle<F::Output>

where F: Future + Send + 'static, F::Output: Send + 'static,

Runs the provided asynchronous task.

pub fn spawn_blocking<F, R>(task: F) -> TaskHandle<R>

where F: FnOnce() -> R + Send + 'static, R: Send + 'static,

Runs the provided synchronous task on a thread where blocking is acceptable.

pub async fn shutdown<R>(task: TaskHandle<R>) -> Result<R, TaskError>

Shuts down the task, and then checks for a result.

Returns the result if the task finishes while shutting down, TaskError if the task died before returning.

pub async fn await_many<R, const N: usize>( tasks: [TaskHandle<R>; N], ) -> Result<Vec<R>, TaskError>

where R: 'static,

Await many tasks at once and returns their results in order, or returns the first error that occurs.