Function futures_util::future::select_ok

source · [−]

pub fn select_ok<I>(iter: I) -> SelectOk<I::Item>ⓘNotable traits for SelectOk<Fut>impl<Fut: TryFuture + Unpin> Future for SelectOk<Fut>    type Output = Result<(Fut::Ok, Vec<Fut>), Fut::Error>;where
    I: IntoIterator,
    I::Item: TryFuture + Unpin,

Expand description

Creates a new future which will select the first successful future over a list of futures.

The returned future will wait for any future within iter to be ready and Ok. Unlike select_all, this will only return the first successful completion, or the last failure. This is useful in contexts where any success is desired and failures are ignored, unless all the futures fail.

This function is only available when the std or alloc feature of this library is activated, and it is activated by default.

Panics

This function will panic if the iterator specified contains no items.