Struct futures::future::Abortable[][src]

#[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.

Implementations

impl<Fut> Abortable<Fut> where
    Fut: Future
[src]

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

Notable traits for Abortable<Fut>

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

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
[src]

impl<Fut> Debug for Abortable<Fut> where
    Fut: Debug
[src]

impl<Fut> Future for Abortable<Fut> where
    Fut: Future
[src]

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

The type of value produced on completion.

impl<'__pin, Fut> Unpin for Abortable<Fut> where
    __Origin<'__pin, Fut>: Unpin
[src]

Auto Trait Implementations

impl<Fut> !RefUnwindSafe for Abortable<Fut>

impl<Fut> Send for Abortable<Fut> where
    Fut: Send

impl<Fut> Sync for Abortable<Fut> where
    Fut: Sync

impl<Fut> !UnwindSafe for Abortable<Fut>

Blanket Implementations

impl<T> Any for T where
    T: 'static + ?Sized
[src]

impl<T> Borrow<T> for T where
    T: ?Sized
[src]

impl<T> BorrowMut<T> for T where
    T: ?Sized
[src]

impl<T> From<T> for T[src]

impl<T> FutureExt for T where
    T: Future + ?Sized
[src]

impl<T, U> Into<U> for T where
    U: From<T>, 
[src]

impl<F> IntoFuture for F where
    F: Future
[src]

type Output = <F as Future>::Output

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

The output that the future will produce on completion.

type Future = F

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

Which kind of future are we turning this into?

impl<T> ToOwned for T where
    T: Clone
[src]

type Owned = T

The resulting type after obtaining ownership.

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
[src]

type Error = Infallible

The type returned in the event of a conversion error.

impl<F, T, E> TryFuture for F where
    F: Future<Output = Result<T, E>> + ?Sized
[src]

type Ok = T

The type of successful values yielded by this future

type Error = E

The type of failures yielded by this future

impl<Fut> TryFutureExt for Fut where
    Fut: TryFuture + ?Sized
[src]

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.