Struct futures::stream::StreamFuture

#[must_use = "futures do nothing unless you `.await` or poll them"]
pub struct StreamFuture<St> { /* fields omitted */ }

Future for the into_future method.

Methods

impl<St> StreamFuture<St> where
    St: Unpin + Stream, 

pub fn get_ref(&self) -> Option<&St>

Acquires a reference to the underlying stream that this combinator is pulling from.

This method returns an Option to account for the fact that StreamFuture's implementation of Future::poll consumes the underlying stream during polling in order to return it to the caller of Future::poll if the stream yielded an element.

pub fn get_mut(&mut self) -> Option<&mut St>

Acquires a mutable reference to the underlying stream that this combinator is pulling from.

Note that care must be taken to avoid tampering with the state of the stream which may otherwise confuse this combinator.

This method returns an Option to account for the fact that StreamFuture's implementation of Future::poll consumes the underlying stream during polling in order to return it to the caller of Future::poll if the stream yielded an element.

pub fn get_pin_mut(self: Pin<&mut StreamFuture<St>>) -> Option<Pin<&mut St>>

Acquires a pinned mutable reference to the underlying stream that this combinator is pulling from.

Note that care must be taken to avoid tampering with the state of the stream which may otherwise confuse this combinator.

This method returns an Option to account for the fact that StreamFuture's implementation of Future::poll consumes the underlying stream during polling in order to return it to the caller of Future::poll if the stream yielded an element.

pub fn into_inner(self) -> Option<St>

Consumes this combinator, returning the underlying stream.

Note that this may discard intermediate state of this combinator, so care should be taken to avoid losing resources when this is called.

This method returns an Option to account for the fact that StreamFuture's implementation of Future::poll consumes the underlying stream during polling in order to return it to the caller of Future::poll if the stream yielded an element.

Trait Implementations

impl<St> Future for StreamFuture<St> where
    St: Unpin + Stream, 

type Output = (Option<<St as Stream>::Item>, St)

The type of value produced on completion.

fn poll(
    self: Pin<&mut StreamFuture<St>>,
    cx: &mut Context
) -> Poll<<StreamFuture<St> as Future>::Output>

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

impl<St> Unpin for StreamFuture<St> where
    St: Unpin + Stream, 

impl<St> Debug for StreamFuture<St> where
    St: Debug, 

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

Formats the value using the given formatter.

impl<St> FusedFuture for StreamFuture<St> where
    St: Unpin + Stream, 

fn is_terminated(&self) -> bool

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