[−][src]Function heim_common::prelude::futures::future::select_ok
pub fn select_ok<I>(iter: I) -> SelectOk<<I as IntoIterator>::Item>ⓘ where
I: IntoIterator,
<I as IntoIterator>::Item: TryFuture,
<I as IntoIterator>::Item: Unpin,
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.