Struct futures::future::Abortable

#[must_use = "futures do nothing unless you `.await` or poll them"]
pub struct Abortable<Fut> { /* fields omitted */ }

A future which can be remotely short-circuited using an AbortHandle.

Methods

impl<Fut> Abortable<Fut> where
    Fut: Future, 

Important traits for Abortable<Fut>

impl<Fut> Future for Abortable<Fut> where
    Fut: Future,  type Output = Result<<Fut as Future>::Output, Aborted>;

pub fn new(future: Fut, reg: AbortRegistration) -> Abortable<Fut>

Creates a new Abortable future using an existing AbortRegistration. AbortRegistrations can be acquired through AbortHandle::new.

When abort is called on the handle tied to reg or if abort has already been called, the future will complete immediately without making any further progress.

Example:

use futures::future::{Abortable, AbortHandle, Aborted};

let (abort_handle, abort_registration) = AbortHandle::new_pair();
let future = Abortable::new(async { 2 }, abort_registration);
abort_handle.abort();
assert_eq!(future.await, Err(Aborted));

Trait Implementations

impl<Fut> Clone for Abortable<Fut> where
    Fut: Clone, 

Important traits for Abortable<Fut>

impl<Fut> Future for Abortable<Fut> where
    Fut: Future,  type Output = Result<<Fut as Future>::Output, Aborted>;

fn clone(&self) -> Abortable<Fut>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<Fut> Debug for Abortable<Fut> where
    Fut: Debug, 

fn fmt(&self, f: &mut Formatter) -> Result<(), Error>

Formats the value using the given formatter.

impl<Fut> Future for Abortable<Fut> where
    Fut: Future, 

type Output = Result<<Fut as Future>::Output, Aborted>

The type of value produced on completion.

fn poll(
    self: Pin<&mut Abortable<Fut>>,
    cx: &mut Context
) -> Poll<<Abortable<Fut> as Future>::Output>

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

impl<Fut> Unpin for Abortable<Fut> where
    Fut: Unpin,