Skip to main content

TokioTaskHandle

Struct TokioTaskHandle 

Source
pub struct TokioTaskHandle<R, E> { /* private fields */ }
Expand description

Async handle returned by Tokio-backed executor services.

Awaiting this handle reports the accepted task’s final result, including task failure, panic, or cancellation.

§Type Parameters

  • R - The task success value.
  • E - The task error value.

Implementations§

Source§

impl<R, E> TokioTaskHandle<R, E>

Source

pub fn cancel(&self) -> bool

Requests cancellation of the underlying Tokio task.

For blocking tasks submitted through spawn_blocking, Tokio can prevent execution only if the task has not started yet. Already running blocking work continues until the closure returns.

§Returns

true after cancellation has been requested.

Source

pub fn is_done(&self) -> bool

Returns whether the underlying Tokio task has finished.

§Returns

true if the Tokio task is complete.

Trait Implementations§

Source§

impl<R, E> Future for TokioTaskHandle<R, E>

Source§

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

Polls the underlying Tokio task.

§Parameters
  • cx - Async task context used to register the current waker.
§Returns

Poll::Ready with the task result when the Tokio task completes, or Poll::Pending while it is still running. Tokio cancellation and panic join errors are converted to TaskExecutionError values.

Source§

type Output = Result<R, TaskExecutionError<E>>

The type of value produced on completion.

Auto Trait Implementations§

§

impl<R, E> Freeze for TokioTaskHandle<R, E>

§

impl<R, E> RefUnwindSafe for TokioTaskHandle<R, E>

§

impl<R, E> Send for TokioTaskHandle<R, E>
where R: Send, E: Send,

§

impl<R, E> Sync for TokioTaskHandle<R, E>
where R: Send, E: Send,

§

impl<R, E> Unpin for TokioTaskHandle<R, E>

§

impl<R, E> UnsafeUnpin for TokioTaskHandle<R, E>

§

impl<R, E> UnwindSafe for TokioTaskHandle<R, E>

Blanket Implementations§

Source§

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

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

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

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where 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 T
where 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<F> IntoFuture for F
where F: Future,

Source§

type Output = <F as Future>::Output

The output that the future will produce on completion.
Source§

type IntoFuture = F

Which kind of future are we turning this into?
Source§

fn into_future(self) -> <F as IntoFuture>::IntoFuture

Creates a future from a value. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

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 T
where U: TryFrom<T>,

Source§

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.