Enum futures_util::future::Either

[−] Show declaration

pub enum Either<A, B> {
    Left(A),
    Right(B),
}

[−] Expand description

Combines two different futures, streams, or sinks having the same associated types into a single type.

Variants

Left(A)

[−] Expand description

First branch of the type

Right(B)

[−] Expand description

Second branch of the type

Implementations

impl<A, B, T> Either<(T, A), (T, B)>[−]

pub fn factor_first(self) -> (T, Either<A, B>)[−]

Factor out a homogeneous type from an either of pairs.

Here, the homogeneous type is the first element of the pairs.

impl<A, B, T> Either<(A, T), (B, T)>[−]

pub fn factor_second(self) -> (Either<A, B>, T)[−]

Factor out a homogeneous type from an either of pairs.

Here, the homogeneous type is the second element of the pairs.

impl<T> Either<T, T>[−]

pub fn into_inner(self) -> T[−]

Extract the value of an either over two equivalent types.

Trait Implementations

impl<A: Clone, B: Clone> Clone for Either<A, B>[+]

[+] Show hidden undocumented items

fn clone(&self) -> Either<A, B>[−]

Returns a copy of the value.

pub fn clone_from(&mut self, source: &Self)[−]

Performs copy-assignment from source.

impl<A: Debug, B: Debug> Debug for Either<A, B>[+]

[+] Show hidden undocumented items

fn fmt(&self, f: &mut Formatter<'_>) -> Result[−]

Formats the value using the given formatter.

impl<A, B> FusedFuture for Either<A, B> where
    A: FusedFuture,
    B: FusedFuture<Output = A::Output>, [+]

[+] Show hidden undocumented items

fn is_terminated(&self) -> bool[−]

Returns true if the underlying future should no longer be polled.

impl<A, B> FusedStream for Either<A, B> where
    A: FusedStream,
    B: FusedStream<Item = A::Item>, [+]

[+] Show hidden undocumented items

fn is_terminated(&self) -> bool[−]

Returns true if the stream should no longer be polled.

impl<A, B> Future for Either<A, B> where
    A: Future,
    B: Future<Output = A::Output>, [+]

[+] Show hidden undocumented items

type Output = A::Output

The type of value produced on completion.

fn poll(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<Self::Output>[−]

Attempt to resolve the future to a final value, registering the current task for wakeup if the value is not yet available.

impl<A, B, Item> Sink<Item> for Either<A, B> where
    A: Sink<Item>,
    B: Sink<Item, Error = A::Error>, [+]

[+] Show hidden undocumented items

type Error = A::Error

The type of value produced by the sink when an error occurs.

fn poll_ready(
    self: Pin<&mut Self>,
    cx: &mut Context<'_>
) -> Poll<Result<(), Self::Error>>[−]

Attempts to prepare the Sink to receive a value.

fn start_send(self: Pin<&mut Self>, item: Item) -> Result<(), Self::Error>[−]

Begin the process of sending a value to the sink. Each call to this function must be preceded by a successful call to poll_ready which returned Poll::Ready(Ok(())).

fn poll_flush(
    self: Pin<&mut Self>,
    cx: &mut Context<'_>
) -> Poll<Result<(), Self::Error>>[−]

Flush any remaining output from this sink.

fn poll_close(
    self: Pin<&mut Self>,
    cx: &mut Context<'_>
) -> Poll<Result<(), Self::Error>>[−]

Flush any remaining output and close this sink, if necessary.

impl<A, B> Stream for Either<A, B> where
    A: Stream,
    B: Stream<Item = A::Item>, [+]

[+] Show hidden undocumented items

type Item = A::Item

Values yielded by the stream.

fn poll_next(
    self: Pin<&mut Self>,
    cx: &mut Context<'_>
) -> Poll<Option<Self::Item>>[−]

Attempt to pull out the next value of this stream, registering the current task for wakeup if the value is not yet available, and returning None if the stream is exhausted.

fn size_hint(&self) -> (usize, Option<usize>)[−]

Returns the bounds on the remaining length of the stream.