ordered_stream

Struct FromStreamDirect

source
pub struct FromStreamDirect<S, F> { /* private fields */ }
Expand description

An OrderedStream wrapper around a Stream.

This does not use any future or past knowledge of elements, and so is suitable if the stream rarely or never blocks. Prefer using FromStream if you plan to filter or join this stream and want other streams to be able to make progress while this one blocks.

Implementations§

source§

impl<S, F> FromStreamDirect<S, F>

source

pub fn new<Ordering, Data>(stream: S, split_item: F) -> Self
where S: Stream, F: FnMut(S::Item) -> (Ordering, Data), Ordering: Ord,

Create a new OrderedStream by applying a split_item closure to each element produced by the original stream.

source

pub fn with_ordering<Ordering>( stream: S, get_ordering: F, ) -> FromStreamDirect<S, impl FnMut(S::Item) -> (Ordering, S::Item)>
where S: Stream, F: FnMut(&S::Item) -> Ordering, Ordering: Ord,

Helper function to simplify the creation of a stream when you have a get_ordering function.

Trait Implementations§

source§

impl<S: Debug, F: Debug> Debug for FromStreamDirect<S, F>

source§

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

Formats the value using the given formatter. Read more
source§

impl<S, F, Ordering, Data> FusedOrderedStream for FromStreamDirect<S, F>
where S: FusedStream, F: FnMut(S::Item) -> (Ordering, Data), Ordering: Ord,

source§

fn is_terminated(&self) -> bool

Returns true if the stream should no longer be polled.
source§

impl<S, F, Ordering, Data> OrderedStream for FromStreamDirect<S, F>
where S: Stream, F: FnMut(S::Item) -> (Ordering, Data), Ordering: Ord,

source§

type Data = Data

The unordered data carried by this stream Read more
source§

type Ordering = Ordering

The type ordered by this stream. Read more
source§

fn poll_next_before( self: Pin<&mut Self>, cx: &mut Context<'_>, _: Option<&Self::Ordering>, ) -> Poll<PollResult<Self::Ordering, Self::Data>>

Attempt to pull out the next value of this stream, registering the current task for wakeup if needed, and returning NoneBefore if it is known that the stream will not produce any more values ordered before the given point. Read more
source§

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

Returns the bounds on the remaining length of the stream.
source§

fn position_hint(&self) -> Option<MaybeBorrowed<'_, Self::Ordering>>

The minimum value of the ordering for any future items. Read more
source§

impl<'__pin, S, F> Unpin for FromStreamDirect<S, F>
where PinnedFieldsOf<__Origin<'__pin, S, F>>: Unpin,

Auto Trait Implementations§

§

impl<S, F> Freeze for FromStreamDirect<S, F>
where S: Freeze, F: Freeze,

§

impl<S, F> RefUnwindSafe for FromStreamDirect<S, F>

§

impl<S, F> Send for FromStreamDirect<S, F>
where S: Send, F: Send,

§

impl<S, F> Sync for FromStreamDirect<S, F>
where S: Sync, F: Sync,

§

impl<S, F> UnwindSafe for FromStreamDirect<S, F>
where S: UnwindSafe, F: UnwindSafe,

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> OrderedStreamExt for T
where T: OrderedStream + ?Sized,

source§

fn map<F, R>(self, f: F) -> Map<Self, F>
where Self: Sized, F: FnMut(Self::Data) -> R,

Apply a closure to the data. Read more
source§

fn map_item<F, R>(self, f: F) -> MapItem<Self, F>
where Self: Sized, F: FnMut(&Self::Ordering, Self::Data) -> R,

Apply a closure to the items that has access to the ordering data.
source§

fn map_ordering<NewOrdering, NewData, MapInto, MapFrom>( self, map_into: MapInto, map_from: MapFrom, ) -> MapOrdering<Self, MapInto, MapFrom>
where Self: Sized, MapInto: FnMut(Self::Ordering, Self::Data) -> (NewOrdering, NewData), MapFrom: FnMut(&NewOrdering) -> Option<Self::Ordering>, NewOrdering: Ord,

Apply a closure to the items that can change the type of the ordering value. Read more
source§

fn filter<F>(self, filter: F) -> Filter<Self, F>
where Self: Sized, F: FnMut(&Self::Data) -> bool,

source§

fn filter_map<F, R>(self, filter: F) -> FilterMap<Self, F>
where Self: Sized, F: FnMut(Self::Data) -> Option<R>,

source§

fn then<F, Fut>(self, then: F) -> Then<Self, F, Fut>
where Self: Sized, F: FnMut(Self::Data) -> Fut, Fut: Future,

Apply a closure that produces a Future to items, running the future on each item in sequence before processing the next. Read more
source§

fn into_stream(self) -> IntoStream<Self>
where Self: Sized,

Convert this into a Stream, discarding the ordering information.
source§

fn into_tuple_stream(self) -> IntoTupleStream<Self>
where Self: Sized,

Convert this into a Stream, keeping the ordering objects.
source§

fn into_ordering(self) -> IntoOrdering<Self>
where Self: Sized,

Convert this into a Stream, keeping only the ordering objects.
source§

fn next(&mut self) -> Next<'_, Self>
where Self: Unpin,

Return the next item in this stream.
source§

fn next_before<'a>( &'a mut self, before: Option<&'a Self::Ordering>, ) -> NextBefore<'a, Self>
where Self: Unpin,

Return a PollResult corresponding to the next item in the stream.
source§

fn peekable(self) -> Peekable<Self>
where Self: Sized,

source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

source§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.