Function futures_util::future::try_join_all
source · [−]pub fn try_join_all<I>(i: I) -> TryJoinAll<I::Item>ⓘNotable traits for TryJoinAll<F>impl<F> Future for TryJoinAll<F> where
F: TryFuture, type Output = Result<Vec<F::Ok>, F::Error>;
where
I: IntoIterator,
I::Item: TryFuture,
Expand description
Creates a future which represents either a collection of the results of the futures given or an error.
The returned future will drive execution for all of its underlying futures,
collecting the results into a destination Vec<T>
in the same order as they
were provided.
If any future returns an error then all other futures will be canceled and
an error will be returned immediately. If all futures complete successfully,
however, then the returned future will succeed with a Vec
of all the
successful results.
This function is only available when the std
or alloc
feature of this
library is activated, and it is activated by default.
Examples
use futures::future::{self, try_join_all};
let futures = vec![
future::ok::<u32, u32>(1),
future::ok::<u32, u32>(2),
future::ok::<u32, u32>(3),
];
assert_eq!(try_join_all(futures).await, Ok(vec![1, 2, 3]));
let futures = vec![
future::ok::<u32, u32>(1),
future::err::<u32, u32>(2),
future::ok::<u32, u32>(3),
];
assert_eq!(try_join_all(futures).await, Err(2));