Trait futures_concurrency::Race

pub trait Race {
    type Output;

    fn race<'async_trait>(
        self
    ) -> Pin<Box<dyn Future<Output = Self::Output> + 'async_trait>>
    where
        Self: 'async_trait;
}

Wait for the first future to complete.

Awaits multiple futures simultaneously, returning the output of the first future which completes.

Required Associated Types

type Output

The resulting output type.

Required Methods

fn race<'async_trait>(
    self
) -> Pin<Box<dyn Future<Output = Self::Output> + 'async_trait>>where
    Self: 'async_trait,

Waits for multiple futures to complete.

Awaits multiple futures simultaneously, returning the output of the futures once both complete.

This function returns a new future which polls both futures concurrently.

Implementations on Foreign Types

impl<Fut, const N: usize> Race for [Fut; N]where
    Fut: IntoFuture,

type Output = <Fut as IntoFuture>::Output

fn race<'async_trait>(
    self
) -> Pin<Box<dyn Future<Output = Self::Output> + 'async_trait>>where
    Self: 'async_trait,

impl<T, A, B> Race for (A, B)where
    A: IntoFuture<Output = T>,
    B: IntoFuture<Output = T>,

type Output = T

fn race<'async_trait>(
    self
) -> Pin<Box<dyn Future<Output = Self::Output> + 'async_trait>>where
    Self: 'async_trait,

impl<T, A, B, C> Race for (A, B, C)where
    A: IntoFuture<Output = T>,
    B: IntoFuture<Output = T>,
    C: IntoFuture<Output = T>,

type Output = T

fn race<'async_trait>(
    self
) -> Pin<Box<dyn Future<Output = Self::Output> + 'async_trait>>where
    Self: 'async_trait,

impl<T, A, B, C, D> Race for (A, B, C, D)where
    A: IntoFuture<Output = T>,
    B: IntoFuture<Output = T>,
    C: IntoFuture<Output = T>,
    D: IntoFuture<Output = T>,

type Output = T

fn race<'async_trait>(
    self
) -> Pin<Box<dyn Future<Output = Self::Output> + 'async_trait>>where
    Self: 'async_trait,

impl<T, A, B, C, D, E> Race for (A, B, C, D, E)where
    A: IntoFuture<Output = T>,
    B: IntoFuture<Output = T>,
    C: IntoFuture<Output = T>,
    D: IntoFuture<Output = T>,
    E: IntoFuture<Output = T>,

type Output = T

fn race<'async_trait>(
    self
) -> Pin<Box<dyn Future<Output = Self::Output> + 'async_trait>>where
    Self: 'async_trait,

impl<T, A, B, C, D, E, F> Race for (A, B, C, D, E, F)where
    A: IntoFuture<Output = T>,
    B: IntoFuture<Output = T>,
    C: IntoFuture<Output = T>,
    D: IntoFuture<Output = T>,
    E: IntoFuture<Output = T>,
    F: IntoFuture<Output = T>,

type Output = T

fn race<'async_trait>(
    self
) -> Pin<Box<dyn Future<Output = Self::Output> + 'async_trait>>where
    Self: 'async_trait,

impl<T, A, B, C, D, E, F, G> Race for (A, B, C, D, E, F, G)where
    A: IntoFuture<Output = T>,
    B: IntoFuture<Output = T>,
    C: IntoFuture<Output = T>,
    D: IntoFuture<Output = T>,
    E: IntoFuture<Output = T>,
    F: IntoFuture<Output = T>,
    G: IntoFuture<Output = T>,

type Output = T

fn race<'async_trait>(
    self
) -> Pin<Box<dyn Future<Output = Self::Output> + 'async_trait>>where
    Self: 'async_trait,

impl<T, A, B, C, D, E, F, G, H> Race for (A, B, C, D, E, F, G, H)where
    A: IntoFuture<Output = T>,
    B: IntoFuture<Output = T>,
    C: IntoFuture<Output = T>,
    D: IntoFuture<Output = T>,
    E: IntoFuture<Output = T>,
    F: IntoFuture<Output = T>,
    G: IntoFuture<Output = T>,
    H: IntoFuture<Output = T>,

type Output = T

fn race<'async_trait>(
    self
) -> Pin<Box<dyn Future<Output = Self::Output> + 'async_trait>>where
    Self: 'async_trait,

impl<T, A, B, C, D, E, F, G, H, I> Race for (A, B, C, D, E, F, G, H, I)where
    A: IntoFuture<Output = T>,
    B: IntoFuture<Output = T>,
    C: IntoFuture<Output = T>,
    D: IntoFuture<Output = T>,
    E: IntoFuture<Output = T>,
    F: IntoFuture<Output = T>,
    G: IntoFuture<Output = T>,
    H: IntoFuture<Output = T>,
    I: IntoFuture<Output = T>,

type Output = T

fn race<'async_trait>(
    self
) -> Pin<Box<dyn Future<Output = Self::Output> + 'async_trait>>where
    Self: 'async_trait,

impl<T, A, B, C, D, E, F, G, H, I, J> Race for (A, B, C, D, E, F, G, H, I, J)where
    A: IntoFuture<Output = T>,
    B: IntoFuture<Output = T>,
    C: IntoFuture<Output = T>,
    D: IntoFuture<Output = T>,
    E: IntoFuture<Output = T>,
    F: IntoFuture<Output = T>,
    G: IntoFuture<Output = T>,
    H: IntoFuture<Output = T>,
    I: IntoFuture<Output = T>,
    J: IntoFuture<Output = T>,

type Output = T

fn race<'async_trait>(
    self
) -> Pin<Box<dyn Future<Output = Self::Output> + 'async_trait>>where
    Self: 'async_trait,

impl<T, A, B, C, D, E, F, G, H, I, J, K> Race for (A, B, C, D, E, F, G, H, I, J, K)where
    A: IntoFuture<Output = T>,
    B: IntoFuture<Output = T>,
    C: IntoFuture<Output = T>,
    D: IntoFuture<Output = T>,
    E: IntoFuture<Output = T>,
    F: IntoFuture<Output = T>,
    G: IntoFuture<Output = T>,
    H: IntoFuture<Output = T>,
    I: IntoFuture<Output = T>,
    J: IntoFuture<Output = T>,
    K: IntoFuture<Output = T>,

type Output = T

fn race<'async_trait>(
    self
) -> Pin<Box<dyn Future<Output = Self::Output> + 'async_trait>>where
    Self: 'async_trait,

impl<T, A, B, C, D, E, F, G, H, I, J, K, L> Race for (A, B, C, D, E, F, G, H, I, J, K, L)where
    A: IntoFuture<Output = T>,
    B: IntoFuture<Output = T>,
    C: IntoFuture<Output = T>,
    D: IntoFuture<Output = T>,
    E: IntoFuture<Output = T>,
    F: IntoFuture<Output = T>,
    G: IntoFuture<Output = T>,
    H: IntoFuture<Output = T>,
    I: IntoFuture<Output = T>,
    J: IntoFuture<Output = T>,
    K: IntoFuture<Output = T>,
    L: IntoFuture<Output = T>,

type Output = T

fn race<'async_trait>(
    self
) -> Pin<Box<dyn Future<Output = Self::Output> + 'async_trait>>where
    Self: 'async_trait,

impl<Fut> Race for Vec<Fut>where
    Fut: IntoFuture,

type Output = <Fut as IntoFuture>::Output

fn race<'async_trait>(
    self
) -> Pin<Box<dyn Future<Output = Self::Output> + 'async_trait>>where
    Self: 'async_trait,

Implementors