Struct Task 

pub struct Task<T> { /* private fields */ }

A handle to a spawned Task.

If this handle is dropped, the task is cancelled where possible. In order to allow the task to continue running in the background, call Task::detach.

Implementations

impl<T> Task<T>

pub fn detach(self)

Detach the task, allowing it to continue running in the background after being dropped. This is only possible if the underlying runtime has a ’static lifetime.

pub fn poll_join(&mut self, cx: &mut Context<'_>) -> Poll<JoinOutcome<T>>

Poll the task to completion, reporting the terminal state as a JoinOutcome instead of re-raising a panic or panicking on abort.

This lets a caller distinguish a task panic (which it may re-raise via std::panic::resume_unwind) from the runtime dropping the task before it completed — for example a runtime shutting down while work is in flight — which is benign. The Future implementation, by contrast, re-raises a panic and itself panics on abort.

Trait Implementations

impl<T> Drop for Task<T>

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl<T> Future for Task<T>

type Output = T

The type of value produced on completion.

fn poll(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<Self::Output>

Attempts to resolve the future to a final value, registering the current task for wakeup if the value is not yet available.