Struct ReusableLocalBoxFuture 

pub struct ReusableLocalBoxFuture<T> { /* private fields */ }

A reusable Pin<Box<dyn Future<Output = T>>.

This type lets you replace the future stored in the box without reallocating when the size and alignment permits this.

Implementations

impl<T> ReusableLocalBoxFuture<T>

pub fn new<F>(future: F) -> Self

where F: Future<Output = T> + 'static,

Create a new ReusableLocalBoxFuture<T> containing the provided future.

pub fn set<F>(&mut self, future: F)

where F: Future<Output = T> + 'static,

Replace the future currently stored in this box.

This reallocates if and only if the layout of the provided future is different from the layout of the currently stored future.

pub fn try_set<F>(&mut self, future: F) -> Result<(), F>

where F: Future<Output = T> + 'static,

Replace the future currently stored in this box.

This function never reallocates, but returns an error if the provided future has a different size or alignment from the currently stored future.

pub fn get_pin(&mut self) -> Pin<&mut dyn Future<Output = T>>

Get a pinned reference to the underlying future.

pub fn poll(&mut self, cx: &mut Context<'_>) -> Poll<T>

Poll the future stored inside this box.

Trait Implementations

impl<T> Debug for ReusableLocalBoxFuture<T>

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

Formats the value using the given formatter.

impl<T> Drop for ReusableLocalBoxFuture<T>

fn drop(&mut self)

Executes the destructor for this type.

impl<T> Future for ReusableLocalBoxFuture<T>

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

Poll the future stored inside this box.

type Output = T

The type of value produced on completion.

impl<T> Unpin for ReusableLocalBoxFuture<T>