Struct async_ops::Async [−][src]
pub struct Async<Fut: Future> { /* fields omitted */ }
Expand description
Implementations
Wraps the inner Future
in Async
with the given Assignable
type
so that it can be used with Assign
variants of std::ops
traits.
See also async_ops::assignable
.
Example
use futures::executor::block_on;
use futures::future::LocalBoxFuture;
let a = async { 40 };
let b = async { 2 };
let result = async {
let mut a = async_ops::on(a).assignable::<LocalBoxFuture<usize>>();
a += b;
a.await
};
assert_eq!(42, block_on(result));
Does the given Unary
operation Op
on the wrapped Future
in
Async
and returns the result in a new Async
.
Example
use std::future::{ready, Ready};
use futures::executor::block_on;
use async_ops::Unary;
struct Return42;
impl<Operand> Unary<Operand> for Return42 {
type Output = Ready<usize>;
fn op(_: Operand) -> Self::Output {
ready(42)
}
}
let a = async { 2 };
let result = async {
async_ops::on(a).unary_op(Return42).await
};
assert_eq!(42, block_on(result));
Does the given Binary
operation Op
on the wrapped Future
in
Async
and the given right-hand operand and returns the result in a new
Async
.
See also Async::op_assign
.
Example
use futures::executor::block_on;
use async_ops::Binary;
struct ReturnRhs;
impl<Lhs, Rhs> Binary<Lhs, Rhs> for ReturnRhs {
type Output = Rhs;
fn op(_: Lhs, rhs: Rhs) -> Self::Output {
rhs
}
}
let a = async { 2 };
let b = async { 42 };
let result = async {
async_ops::on(a).op(ReturnRhs, b).await
};
assert_eq!(42, block_on(result));
Does the given Binary
operation Op
on the wrapped Future
in
Async
and the given right-hand operand and assigns it to self
.
See also Async::op
.
Example
use futures::executor::block_on;
use async_ops::Binary;
struct ReturnRhs;
impl<Lhs, Rhs> Binary<Lhs, Rhs> for ReturnRhs {
type Output = Rhs;
fn op(_: Lhs, rhs: Rhs) -> Self::Output {
rhs
}
}
let a = async { 2 };
let b = async { 42 };
let result = async {
let mut a = async_ops::assignable(a);
a.op_assign(ReturnRhs, b);
a.await
};
assert_eq!(42, block_on(result));
Trait Implementations
Performs the +=
operation. Read more
impl<Lhs, Rhs> BitAndAssign<Rhs> for Async<Lhs> where
Lhs: Assignable<AsyncBitAnd<Lhs, Rhs>> + Future,
Rhs: Future,
<Lhs as Future>::Output: BitAnd<Rhs::Output>,
impl<Lhs, Rhs> BitAndAssign<Rhs> for Async<Lhs> where
Lhs: Assignable<AsyncBitAnd<Lhs, Rhs>> + Future,
Rhs: Future,
<Lhs as Future>::Output: BitAnd<Rhs::Output>,
Performs the &=
operation. Read more
impl<Lhs, Rhs> BitOrAssign<Rhs> for Async<Lhs> where
Lhs: Assignable<AsyncBitOr<Lhs, Rhs>> + Future,
Rhs: Future,
<Lhs as Future>::Output: BitOr<Rhs::Output>,
impl<Lhs, Rhs> BitOrAssign<Rhs> for Async<Lhs> where
Lhs: Assignable<AsyncBitOr<Lhs, Rhs>> + Future,
Rhs: Future,
<Lhs as Future>::Output: BitOr<Rhs::Output>,
Performs the |=
operation. Read more
impl<Lhs, Rhs> BitXorAssign<Rhs> for Async<Lhs> where
Lhs: Assignable<AsyncBitXor<Lhs, Rhs>> + Future,
Rhs: Future,
<Lhs as Future>::Output: BitXor<Rhs::Output>,
impl<Lhs, Rhs> BitXorAssign<Rhs> for Async<Lhs> where
Lhs: Assignable<AsyncBitXor<Lhs, Rhs>> + Future,
Rhs: Future,
<Lhs as Future>::Output: BitXor<Rhs::Output>,
Performs the ^=
operation. Read more
Performs the /=
operation. Read more
Performs the *=
operation. Read more
Performs the %=
operation. Read more
Performs the <<=
operation. Read more
Performs the >>=
operation. Read more
Performs the -=
operation. Read more
Auto Trait Implementations
impl<Fut> RefUnwindSafe for Async<Fut> where
Fut: RefUnwindSafe,
impl<Fut> UnwindSafe for Async<Fut> where
Fut: UnwindSafe,
Blanket Implementations
Mutably borrows from an owned value. Read more
Map this future’s output to a different type, returning a new future of the resulting type. Read more
Map this future’s output to a different type, returning a new future of the resulting type. Read more
Chain on a computation for when a future finished, passing the result of
the future to the provided closure f
. Read more
fn left_future<B>(self) -> Either<Self, B> where
B: Future<Output = Self::Output>,
fn left_future<B>(self) -> Either<Self, B> where
B: Future<Output = Self::Output>,
Wrap this future in an Either
future, making it the left-hand variant
of that Either
. Read more
fn right_future<A>(self) -> Either<A, Self> where
A: Future<Output = Self::Output>,
fn right_future<A>(self) -> Either<A, Self> where
A: Future<Output = Self::Output>,
Wrap this future in an Either
future, making it the right-hand variant
of that Either
. Read more
fn into_stream(self) -> IntoStream<Self>
fn into_stream(self) -> IntoStream<Self>
Convert this future into a single element stream. Read more
Flatten the execution of this future when the output of this future is itself another future. Read more
fn flatten_stream(self) -> FlattenStream<Self> where
Self::Output: Stream,
fn flatten_stream(self) -> FlattenStream<Self> where
Self::Output: Stream,
Flatten the execution of this future when the successful result of this future is a stream. Read more
fn fuse(self) -> Fuse<Self>
fn fuse(self) -> Fuse<Self>
Fuse a future such that poll
will never again be called once it has
completed. This method can be used to turn any Future
into a
FusedFuture
. Read more
Do something with the output of a future before passing it on. Read more
fn catch_unwind(self) -> CatchUnwind<Self> where
Self: UnwindSafe,
fn catch_unwind(self) -> CatchUnwind<Self> where
Self: 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
fn remote_handle(self) -> (Remote<Self>, RemoteHandle<Self::Output>)
fn remote_handle(self) -> (Remote<Self>, RemoteHandle<Self::Output>)
Turn this future into a future that yields ()
on completion and sends
its output to another future on a separate task. Read more
Wrap the future in a Box, pinning it. Read more
Wrap the future in a Box, pinning it. Read more
fn unit_error(self) -> UnitError<Self>
fn unit_error(self) -> UnitError<Self>
Turns a Future<Output = T>
into a
TryFuture<Ok = T, Error = ()
>. Read more
fn never_error(self) -> NeverError<Self>
fn never_error(self) -> NeverError<Self>
Turns a Future<Output = T>
into a
TryFuture<Ok = T, Error = Never
>. Read more
fn poll_unpin(&mut self, cx: &mut Context<'_>) -> Poll<Self::Output> where
Self: Unpin,
fn poll_unpin(&mut self, cx: &mut Context<'_>) -> Poll<Self::Output> where
Self: Unpin,
A convenience for calling Future::poll
on Unpin
future types.
fn now_or_never(self) -> Option<Self::Output>
fn now_or_never(self) -> Option<Self::Output>
Evaluates and consumes the future, returning the resulting output if
the future is ready after the first call to Future::poll
. Read more
into_future
)The output that the future will produce on completion.
type Future = F
type Future = F
into_future
)Which kind of future are we turning this into?
into_future
)Creates a future from a value.
impl<Fut> TryFutureExt for Fut where
Fut: TryFuture + ?Sized,
impl<Fut> TryFutureExt for Fut where
Fut: TryFuture + ?Sized,
fn flatten_sink<Item>(self) -> FlattenSink<Self, Self::Ok> where
Self::Ok: Sink<Item>,
<Self::Ok as Sink<Item>>::Error == Self::Error,
fn flatten_sink<Item>(self) -> FlattenSink<Self, Self::Ok> where
Self::Ok: Sink<Item>,
<Self::Ok as Sink<Item>>::Error == Self::Error,
Flattens the execution of this future when the successful result of this
future is a [Sink
]. Read more
Maps this future’s success value to a different value. Read more
fn map_ok_or_else<T, E, F>(self, e: E, f: F) -> MapOkOrElse<Self, F, E> where
F: FnOnce(Self::Ok) -> T,
E: FnOnce(Self::Error) -> T,
fn map_ok_or_else<T, E, F>(self, e: E, f: F) -> MapOkOrElse<Self, F, E> where
F: FnOnce(Self::Ok) -> T,
E: FnOnce(Self::Error) -> T,
Maps this future’s success value to a different value, and permits for error handling resulting in the same type. Read more
Maps this future’s error value to a different value. Read more
Executes another future after this one resolves successfully. The success value is passed to a closure to create this subsequent future. Read more
Executes another future if this one resolves to an error. The error value is passed to a closure to create this subsequent future. Read more
fn inspect_ok<F>(self, f: F) -> InspectOk<Self, F> where
F: FnOnce(&Self::Ok),
fn inspect_ok<F>(self, f: F) -> InspectOk<Self, F> where
F: FnOnce(&Self::Ok),
Do something with the success value of a future before passing it on. Read more
fn inspect_err<F>(self, f: F) -> InspectErr<Self, F> where
F: FnOnce(&Self::Error),
fn inspect_err<F>(self, f: F) -> InspectErr<Self, F> where
F: FnOnce(&Self::Error),
Do something with the error value of a future before passing it on. Read more
fn try_flatten(self) -> TryFlatten<Self, Self::Ok> where
Self::Ok: TryFuture,
<Self::Ok as TryFuture>::Error == Self::Error,
fn try_flatten(self) -> TryFlatten<Self, Self::Ok> where
Self::Ok: TryFuture,
<Self::Ok as TryFuture>::Error == Self::Error,
Flatten the execution of this future when the successful result of this future is another future. Read more
fn try_flatten_stream(self) -> TryFlattenStream<Self> where
Self::Ok: TryStream,
<Self::Ok as TryStream>::Error == Self::Error,
fn try_flatten_stream(self) -> TryFlattenStream<Self> where
Self::Ok: TryStream,
<Self::Ok as TryStream>::Error == Self::Error,
Flatten the execution of this future when the successful result of this future is a stream. Read more