Struct futures_util::task::LocalFutureObj

pub struct LocalFutureObj<'a, T> { /* fields omitted */ }

A custom trait object for polling futures, roughly akin to Box<dyn Future<Output = T> + 'a>.

This custom trait object was introduced as currently it is not possible to take dyn Trait by value and Box<dyn Trait> is not available in no_std contexts.

Methods

impl<'a, T> LocalFutureObj<'a, T>

Important traits for LocalFutureObj<'_, T>

impl<'_, T> Future for LocalFutureObj<'_, T> type Output = T;

pub fn new<F>(f: F) -> LocalFutureObj<'a, T> where
    F: 'a + UnsafeFutureObj<'a, T>, 

Create a LocalFutureObj from a custom trait object representation.

Important traits for FutureObj<'_, T>

impl<'_, T> Future for FutureObj<'_, T> type Output = T;

pub unsafe fn into_future_obj(self) -> FutureObj<'a, T>

Converts the LocalFutureObj into a FutureObj.

Safety

To make this operation safe one has to ensure that the UnsafeFutureObj instance from which this LocalFutureObj was created actually implements Send.

Trait Implementations

impl<'_, T> Drop for LocalFutureObj<'_, T>

fn drop(&mut self)

Executes the destructor for this type.

impl<'a> From<Box<dyn Future<Output = ()> + 'a>> for LocalFutureObj<'a, ()>

Important traits for LocalFutureObj<'_, T>

impl<'_, T> Future for LocalFutureObj<'_, T> type Output = T;

fn from(boxed: Box<dyn Future<Output = ()> + 'a>) -> LocalFutureObj<'a, ()>

Performs the conversion.

impl<'a, F> From<Pin<Box<F>>> for LocalFutureObj<'a, ()> where
    F: 'a + Future<Output = ()>, 

Important traits for LocalFutureObj<'_, T>

impl<'_, T> Future for LocalFutureObj<'_, T> type Output = T;

fn from(boxed: Pin<Box<F>>) -> LocalFutureObj<'a, ()>

Performs the conversion.

impl<'a> From<Pin<Box<dyn Future<Output = ()> + 'a>>> for LocalFutureObj<'a, ()>

Important traits for LocalFutureObj<'_, T>

impl<'_, T> Future for LocalFutureObj<'_, T> type Output = T;

fn from(boxed: Pin<Box<dyn Future<Output = ()> + 'a>>) -> LocalFutureObj<'a, ()>

Performs the conversion.

impl<'a, T> From<FutureObj<'a, T>> for LocalFutureObj<'a, T>

Important traits for LocalFutureObj<'_, T>

impl<'_, T> Future for LocalFutureObj<'_, T> type Output = T;

fn from(f: FutureObj<'a, T>) -> LocalFutureObj<'a, T>

Performs the conversion.

impl<'a, F> From<Box<F>> for LocalFutureObj<'a, ()> where
    F: 'a + Future<Output = ()>, 

Important traits for LocalFutureObj<'_, T>

impl<'_, T> Future for LocalFutureObj<'_, T> type Output = T;

fn from(boxed: Box<F>) -> LocalFutureObj<'a, ()>

Performs the conversion.

impl<'_, T> Debug for LocalFutureObj<'_, T>

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

Formats the value using the given formatter.

impl<'_, T> Unpin for LocalFutureObj<'_, T>

impl<'_, T> Future for LocalFutureObj<'_, T>

type Output = T

The type of value produced on completion.

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

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