Struct TryParallelBuffered 

pub struct TryParallelBuffered<St>(/* private fields */)
where
    St: TryStream,
    St::Ok: TryFuture<Error = St::Error> + Send + 'static,
    St::Error: Send,
    <St::Ok as TryFuture>::Ok: Send,
    <St::Ok as TryFuture>::Error: Send;

Given a TryStream where every item is a TryFuture, this stream buffers up to a certain number of futures, runs them in parallel on separate tasks, and returns the results of the futures in the same order as in the input stream.

If any of the futures returns an error or panics, all other futures and tasks are immediately cancelled and the error/panic gets returned immediately.

This stream is cancellation safe if the inner stream and generated futures are also cancellation safe. This means that dropping this stream will also cancel any outstanding tasks and drop the relevant futures/streams.

You can use TryParallelBuffered::awaiting_completion to control whether we wait for all tasks to fully terminate before this stream is considered to have ended.

Implementations

impl<St> TryParallelBuffered<St>

where St: TryStream, St::Ok: TryFuture<Error = St::Error> + Send + 'static, St::Error: Send, <St::Ok as TryFuture>::Ok: Send, <St::Ok as TryFuture>::Error: Send,

pub fn awaiting_completion(self, value: bool) -> Self

Whether to always await completion for the tasks from the TryStreamParExt::try_parallel_buffered or TryStreamParExt::try_parallel_buffered_with_token call, even when one of the futures has panicked or been cancelled.

Trait Implementations

impl<St> Debug for TryParallelBuffered<St>

where St: TryStream + Debug, St::Ok: Debug + TryFuture<Error = St::Error> + Send, <St::Ok as TryFuture>::Ok: Debug + Send, <St::Ok as TryFuture>::Error: Debug + Send,

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

Formats the value using the given formatter.

impl<St> Stream for TryParallelBuffered<St>

where St: TryStream, St::Ok: TryFuture<Error = St::Error> + Send + 'static, St::Error: Send, <St::Ok as TryFuture>::Ok: Send, <St::Ok as TryFuture>::Error: Send,

type Item = Result<<<St as TryStream>::Ok as TryFuture>::Ok, <St as TryStream>::Error>

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.

impl<'pin, St> Unpin for TryParallelBuffered<St>

where St: TryStream, St::Ok: TryFuture<Error = St::Error> + Send + 'static, St::Error: Send, <St::Ok as TryFuture>::Ok: Send, <St::Ok as TryFuture>::Error: Send, PinnedFieldsOf<__TryParallelBuffered<'pin, St>>: Unpin,