Struct futures_util::future::Fuse

#[must_use = "futures do nothing unless you `.await` or poll them"]pub struct Fuse<Fut>(_);

Future for the fuse method.

Implementations

impl<Fut: Future> Fuse<Fut>

pub fn terminated() -> Self

Creates a new Fuse-wrapped future which is already terminated.

This can be useful in combination with looping and the select! macro, which bypasses terminated futures.

Examples

use futures::channel::mpsc;
use futures::future::{Fuse, FusedFuture, FutureExt};
use futures::select;
use futures::stream::StreamExt;
use futures::pin_mut;

let (sender, mut stream) = mpsc::unbounded();

// Send a few messages into the stream
sender.unbounded_send(()).unwrap();
sender.unbounded_send(()).unwrap();
drop(sender);

// Use `Fuse::terminated()` to create an already-terminated future
// which may be instantiated later.
let foo_printer = Fuse::terminated();
pin_mut!(foo_printer);

loop {
    select! {
        _ = foo_printer => {},
        () = stream.select_next_some() => {
            if !foo_printer.is_terminated() {
                println!("Foo is already being printed!");
            } else {
                foo_printer.set(async {
                    // do some other async operations
                    println!("Printing foo from `foo_printer` future");
                }.fuse());
            }
        },
        complete => break, // `foo_printer` is terminated and the stream is done
    }
}

Trait Implementations

impl<Fut: Debug> Debug for Fuse<Fut>

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

Formats the value using the given formatter.

impl<Fut: Future> FusedFuture for Fuse<Fut>

pub fn is_terminated(&self) -> bool

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

impl<Fut: Future> Future for Fuse<Fut>

type Output = Fut::Output

The type of value produced on completion.

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

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

impl<'pin, Fut> Unpin for Fuse<Fut> where
    __Fuse<'pin, Fut>: Unpin,