pub struct FirstOk<S>where
S: Stream,{ /* private fields */ }
Expand description
Adapts a stream to a future by taking the first successful item yielded by the stream. If the
stream ends before yielding an Ok
then all the errors that were yielded by the stream are
returned in a vector.
Implementations§
Trait Implementations§
Source§impl<S> Future for FirstOk<S>where
S: Stream,
impl<S> Future for FirstOk<S>where
S: Stream,
Source§type Item = <S as Stream>::Item
type Item = <S as Stream>::Item
The type of value that this future will resolved with if it is
successful.
Source§type Error = Vec<<S as Stream>::Error>
type Error = Vec<<S as Stream>::Error>
The type of error that this future will resolve with if it fails in a
normal fashion.
Source§fn poll(&mut self) -> Result<Async<S::Item>, Vec<S::Error>>
fn poll(&mut self) -> Result<Async<S::Item>, Vec<S::Error>>
Query this future to see if its value has become available, registering
interest if it is not. Read more
Source§fn wait(self) -> Result<Self::Item, Self::Error>where
Self: Sized,
fn wait(self) -> Result<Self::Item, Self::Error>where
Self: Sized,
Block the current thread until this future is resolved. Read more
Source§fn map<F, U>(self, f: F) -> Map<Self, F>
fn map<F, U>(self, f: F) -> Map<Self, F>
Map this future’s result to a different type, returning a new future of
the resulting type. Read more
Source§fn map_err<F, E>(self, f: F) -> MapErr<Self, F>
fn map_err<F, E>(self, f: F) -> MapErr<Self, F>
Map this future’s error to a different error, returning a new future. Read more
Source§fn from_err<E>(self) -> FromErr<Self, E>
fn from_err<E>(self) -> FromErr<Self, E>
Map this future’s error to any error implementing
From
for
this future’s Error
, returning a new future. Read moreSource§fn then<F, B>(self, f: F) -> Then<Self, B, F>
fn then<F, B>(self, f: F) -> Then<Self, B, F>
Chain on a computation for when a future finished, passing the result of
the future to the provided closure
f
. Read moreSource§fn and_then<F, B>(self, f: F) -> AndThen<Self, B, F>
fn and_then<F, B>(self, f: F) -> AndThen<Self, B, F>
Execute another future after this one has resolved successfully. Read more
Source§fn or_else<F, B>(self, f: F) -> OrElse<Self, B, F>
fn or_else<F, B>(self, f: F) -> OrElse<Self, B, F>
Execute another future if this one resolves with an error. Read more
Source§fn select<B>(self, other: B) -> Select<Self, <B as IntoFuture>::Future>
fn select<B>(self, other: B) -> Select<Self, <B as IntoFuture>::Future>
Waits for either one of two futures to complete. Read more
Source§fn select2<B>(self, other: B) -> Select2<Self, <B as IntoFuture>::Future>where
B: IntoFuture,
Self: Sized,
fn select2<B>(self, other: B) -> Select2<Self, <B as IntoFuture>::Future>where
B: IntoFuture,
Self: Sized,
Waits for either one of two differently-typed futures to complete. Read more
Source§fn join<B>(self, other: B) -> Join<Self, <B as IntoFuture>::Future>
fn join<B>(self, other: B) -> Join<Self, <B as IntoFuture>::Future>
Joins the result of two futures, waiting for them both to complete. Read more
Source§fn join3<B, C>(
self,
b: B,
c: C,
) -> Join3<Self, <B as IntoFuture>::Future, <C as IntoFuture>::Future>
fn join3<B, C>( self, b: B, c: C, ) -> Join3<Self, <B as IntoFuture>::Future, <C as IntoFuture>::Future>
Same as
join
, but with more futures.Source§fn join4<B, C, D>(
self,
b: B,
c: C,
d: D,
) -> Join4<Self, <B as IntoFuture>::Future, <C as IntoFuture>::Future, <D as IntoFuture>::Future>where
B: IntoFuture<Error = Self::Error>,
C: IntoFuture<Error = Self::Error>,
D: IntoFuture<Error = Self::Error>,
Self: Sized,
fn join4<B, C, D>(
self,
b: B,
c: C,
d: D,
) -> Join4<Self, <B as IntoFuture>::Future, <C as IntoFuture>::Future, <D as IntoFuture>::Future>where
B: IntoFuture<Error = Self::Error>,
C: IntoFuture<Error = Self::Error>,
D: IntoFuture<Error = Self::Error>,
Self: Sized,
Same as
join
, but with more futures.Source§fn join5<B, C, D, E>(
self,
b: B,
c: C,
d: D,
e: E,
) -> Join5<Self, <B as IntoFuture>::Future, <C as IntoFuture>::Future, <D as IntoFuture>::Future, <E as IntoFuture>::Future>where
B: IntoFuture<Error = Self::Error>,
C: IntoFuture<Error = Self::Error>,
D: IntoFuture<Error = Self::Error>,
E: IntoFuture<Error = Self::Error>,
Self: Sized,
fn join5<B, C, D, E>(
self,
b: B,
c: C,
d: D,
e: E,
) -> Join5<Self, <B as IntoFuture>::Future, <C as IntoFuture>::Future, <D as IntoFuture>::Future, <E as IntoFuture>::Future>where
B: IntoFuture<Error = Self::Error>,
C: IntoFuture<Error = Self::Error>,
D: IntoFuture<Error = Self::Error>,
E: IntoFuture<Error = Self::Error>,
Self: Sized,
Same as
join
, but with more futures.Source§fn into_stream(self) -> IntoStream<Self>where
Self: Sized,
fn into_stream(self) -> IntoStream<Self>where
Self: Sized,
Convert this future into a single element stream. Read more
Source§fn flatten(self) -> Flatten<Self>
fn flatten(self) -> Flatten<Self>
Flatten the execution of this future when the successful result of this
future is itself another future. Read more
Source§fn flatten_stream(self) -> FlattenStream<Self>
fn flatten_stream(self) -> FlattenStream<Self>
Flatten the execution of this future when the successful result of this
future is a stream. Read more
Source§fn fuse(self) -> Fuse<Self>where
Self: Sized,
fn fuse(self) -> Fuse<Self>where
Self: Sized,
Fuse a future such that
poll
will never again be called once it has
completed. Read moreSource§fn inspect<F>(self, f: F) -> Inspect<Self, F>
fn inspect<F>(self, f: F) -> Inspect<Self, F>
Do something with the item of a future, passing it on. Read more
Source§fn catch_unwind(self) -> CatchUnwind<Self>where
Self: Sized + UnwindSafe,
fn catch_unwind(self) -> CatchUnwind<Self>where
Self: Sized + UnwindSafe,
Catches unwinding panics while polling the future. Read more
Create a cloneable handle to this future where all handles will resolve
to the same result. Read more
Auto Trait Implementations§
impl<S> Freeze for FirstOk<S>where
S: Freeze,
impl<S> RefUnwindSafe for FirstOk<S>
impl<S> Send for FirstOk<S>
impl<S> Sync for FirstOk<S>
impl<S> Unpin for FirstOk<S>
impl<S> UnwindSafe for FirstOk<S>
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
Source§impl<T> FutureExt for Twhere
T: Future,
impl<T> FutureExt for Twhere
T: Future,
Source§fn into_boxed(self) -> BoxFuture<Self::Item, Self::Error>where
Self: 'static,
fn into_boxed(self) -> BoxFuture<Self::Item, Self::Error>where
Self: 'static,
Wraps a future into a boxed future, making type-checking easier at the expense of an extra
layer of indirection at runtime.
fn into_send_boxed(self) -> BoxSendFuture<Self::Item, Self::Error>where
Self: Send + 'static,
Source§fn until<C>(self, condition: C) -> Until<Self, C>
fn until<C>(self, condition: C) -> Until<Self, C>
Run this future until some condition is met. If
condition
resolves before self
then
None
is returned. Read moreSource§fn infallible<E>(self) -> Infallible<Self, E>
fn infallible<E>(self) -> Infallible<Self, E>
For futures which can’t fail (ie. which have error type
Void
), cast the error type to
some inferred type.Source§fn log_error(self, level: LogLevel, description: &'static str) -> LogError<Self>
fn log_error(self, level: LogLevel, description: &'static str) -> LogError<Self>
Take a future which returns
()
and log its error if it fails. The returned future cannot
fail and will always resolve to ()
.Source§fn finally<D>(self, on_drop: D) -> Finally<Self, D>where
D: FnOnce(),
fn finally<D>(self, on_drop: D) -> Finally<Self, D>where
D: FnOnce(),
Executes the future and runs the provided callback when the future finishes. The callback
will also be run if the entire future is dropped.
Source§fn with_timeout(self, duration: Duration) -> WithTimeout<Self>
fn with_timeout(self, duration: Duration) -> WithTimeout<Self>
Runs the future for the given duration, returning its value in an option, or returning
None
if the timeout expires.Source§fn with_timeout_at(self, instant: Instant) -> WithTimeout<Self>
fn with_timeout_at(self, instant: Instant) -> WithTimeout<Self>
Runs the future until the given instant, returning its value in an option, or returning
None
if the timeout expires.Source§fn first_ok2<F>(self, other: F) -> FirstOk2<Self, F>
fn first_ok2<F>(self, other: F) -> FirstOk2<Self, F>
Run two futures in parallel and yield the value of the first to return success. If both
futures fail, return both errors.
Source§fn while_driving<F: Future>(self, other: F) -> WhileDriving<Self, F>
fn while_driving<F: Future>(self, other: F) -> WhileDriving<Self, F>
Resolves
self
while driving other
in parallel.Source§fn resume_unwind(self) -> ResumeUnwind<Self>
fn resume_unwind(self) -> ResumeUnwind<Self>
Propogates the result of a
.catch_unwind
, panicking if the future resolves to an Err
Source§impl<F> IntoFuture for Fwhere
F: Future,
impl<F> IntoFuture for Fwhere
F: Future,
Source§fn into_future(self) -> F
fn into_future(self) -> F
Consumes this object and produces a future.