Struct futures_util::task::FutureObj

source · [−]

pub struct FutureObj<'a, T>(_);

Expand description

A custom trait object for polling futures, roughly akin to Box<dyn Future<Output = T> + Send + '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.

You should generally not need to use this type outside of no_std or when implementing Spawn, consider using BoxFuture instead.

Implementations

source

impl<'a, T> FutureObj<'a, T>

source

pub fn new<F>(f: F) -> FutureObj<'a, T>ⓘNotable traits for FutureObj<'_, T>`impl<'_, T> Future for FutureObj<'_, T> type Output = T;` where
F: UnsafeFutureObj<'a, T> + Send,

Create a FutureObj from a custom trait object representation.

Trait Implementations

source

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

source

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

Formats the value using the given formatter. Read more

source

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

source

pub fn from(boxed: Box<F, Global>) -> FutureObj<'a, ()>ⓘNotable traits for FutureObj<'_, T>`impl<'_, T> Future for FutureObj<'_, T> type Output = T;`

Performs the conversion.

source

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

source

pub fn from(
boxed: Box<dyn Future<Output = ()> + Send + 'a, Global>
) -> FutureObj<'a, ()>ⓘNotable traits for FutureObj<'_, T>`impl<'_, T> Future for FutureObj<'_, T> type Output = T;`

Performs the conversion.

source

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

source

pub fn from(f: FutureObj<'a, T>) -> LocalFutureObj<'a, T>ⓘNotable traits for LocalFutureObj<'_, T>`impl<'_, T> Future for LocalFutureObj<'_, T> type Output = T;`

Performs the conversion.

source

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

source

pub fn from(boxed: Pin<Box<F, Global>>) -> FutureObj<'a, ()>ⓘNotable traits for FutureObj<'_, T>`impl<'_, T> Future for FutureObj<'_, T> type Output = T;`

Performs the conversion.

source

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

source

pub fn from(
boxed: Pin<Box<dyn Future<Output = ()> + Send + 'a, Global>>
) -> FutureObj<'a, ()>ⓘNotable traits for FutureObj<'_, T>`impl<'_, T> Future for FutureObj<'_, T> type Output = T;`

Performs the conversion.

source

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

type Output = T

The type of value produced on completion.

source

pub fn poll(self: Pin<&mut FutureObj<'_, 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. Read more

source

impl<'_, T> Send for FutureObj<'_, T>

source

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

Auto Trait Implementations

impl<'a, T> !RefUnwindSafe for FutureObj<'a, T>

impl<'a, T> !Sync for FutureObj<'a, T>

impl<'a, T> !UnwindSafe for FutureObj<'a, T>

Blanket Implementations

source

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

source

pub fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

source

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

const: unstable · source

pub fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

source

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

const: unstable · source

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

Mutably borrows from an owned value. Read more

source

impl<T> From<T> for T

const: unstable · source

pub fn from(t: T) -> T

Returns the argument unchanged.

source

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

const: unstable · source

pub 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<F> IntoFuture for F where
F: Future,

type Output = <F as Future>::Output

🔬 This is a nightly-only experimental API. (into_future)

The output that the future will produce on completion.

type Future = F

🔬 This is a nightly-only experimental API. (into_future)

Which kind of future are we turning this into?

source

pub fn into_future(self) -> <F as IntoFuture>::Future

🔬 This is a nightly-only experimental API. (into_future)

Creates a future from a value.

source

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

type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source

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

Performs the conversion.

source

impl<F, T, E> TryFuture for F where
F: Future<Output = Result<T, E>> + ?Sized,

type Ok = T

The type of successful values yielded by this future

type Error = E

The type of failures yielded by this future

source

pub fn try_poll(
self: Pin<&mut F>,
cx: &mut Context<'_>
) -> Poll<<F as Future>::Output>

Poll this TryFuture as if it were a Future. Read more

source

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

type Error = >::Error

The type returned in the event of a conversion error.

const: unstable · source

pub fn try_into(self) -> Result<U, >::Error>

Performs the conversion.

Struct futures_util::task::FutureObj

Implementations

impl<'a, T> FutureObj<'a, T>

pub fn new<F>(f: F) -> FutureObj<'a, T>ⓘNotable traits for FutureObj<'_, T>impl<'_, T> Future for FutureObj<'_, T> type Output = T; where F: UnsafeFutureObj<'a, T> + Send,

Trait Implementations

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

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

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

pub fn from(boxed: Box<F, Global>) -> FutureObj<'a, ()>ⓘNotable traits for FutureObj<'_, T>impl<'_, T> Future for FutureObj<'_, T> type Output = T;

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

pub fn from( boxed: Box<dyn Future<Output = ()> + Send + 'a, Global>) -> FutureObj<'a, ()>ⓘNotable traits for FutureObj<'_, T>impl<'_, T> Future for FutureObj<'_, T> type Output = T;

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

pub fn from(f: FutureObj<'a, T>) -> LocalFutureObj<'a, T>ⓘNotable traits for LocalFutureObj<'_, T>impl<'_, T> Future for LocalFutureObj<'_, T> type Output = T;

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

pub fn from(boxed: Pin<Box<F, Global>>) -> FutureObj<'a, ()>ⓘNotable traits for FutureObj<'_, T>impl<'_, T> Future for FutureObj<'_, T> type Output = T;

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

pub fn from( boxed: Pin<Box<dyn Future<Output = ()> + Send + 'a, Global>>) -> FutureObj<'a, ()>ⓘNotable traits for FutureObj<'_, T>impl<'_, T> Future for FutureObj<'_, T> type Output = T;

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

type Output = T

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

impl<'_, T> Send for FutureObj<'_, T>

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

Auto Trait Implementations

impl<'a, T> !RefUnwindSafe for FutureObj<'a, T>

impl<'a, T> !Sync for FutureObj<'a, T>

impl<'a, T> !UnwindSafe for FutureObj<'a, T>

Blanket Implementations

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

pub fn type_id(&self) -> TypeId

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

pub fn borrow(&self) -> &T

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

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

impl<T> From<T> for T

pub fn from(t: T) -> T

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

pub fn into(self) -> U

impl<F> IntoFuture for F where F: Future,

type Output = <F as Future>::Output

type Future = F

pub fn into_future(self) -> <F as IntoFuture>::Future

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

type Error = Infallible

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

impl<F, T, E> TryFuture for F where F: Future<Output = Result<T, E>> + ?Sized,

type Ok = T

type Error = E

pub fn try_poll( self: Pin<&mut F>, cx: &mut Context<'_>) -> Poll<<F as Future>::Output>

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

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

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

pub fn new<F>(f: F) -> FutureObj<'a, T>ⓘNotable traits for FutureObj<'_, T>`impl<'_, T> Future for FutureObj<'_, T> type Output = T;` where
F: UnsafeFutureObj<'a, T> + Send,

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

pub fn from(boxed: Box<F, Global>) -> FutureObj<'a, ()>ⓘNotable traits for FutureObj<'_, T>`impl<'_, T> Future for FutureObj<'_, T> type Output = T;`

pub fn from(
boxed: Box<dyn Future<Output = ()> + Send + 'a, Global>
) -> FutureObj<'a, ()>ⓘNotable traits for FutureObj<'_, T>`impl<'_, T> Future for FutureObj<'_, T> type Output = T;`

pub fn from(f: FutureObj<'a, T>) -> LocalFutureObj<'a, T>ⓘNotable traits for LocalFutureObj<'_, T>`impl<'_, T> Future for LocalFutureObj<'_, T> type Output = T;`

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

pub fn from(boxed: Pin<Box<F, Global>>) -> FutureObj<'a, ()>ⓘNotable traits for FutureObj<'_, T>`impl<'_, T> Future for FutureObj<'_, T> type Output = T;`

pub fn from(
boxed: Pin<Box<dyn Future<Output = ()> + Send + 'a, Global>>
) -> FutureObj<'a, ()>ⓘNotable traits for FutureObj<'_, T>`impl<'_, T> Future for FutureObj<'_, T> type Output = T;`

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

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

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

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

impl<F> IntoFuture for F where
F: Future,

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

impl<F, T, E> TryFuture for F where
F: Future<Output = Result<T, E>> + ?Sized,

pub fn try_poll(
self: Pin<&mut F>,
cx: &mut Context<'_>
) -> Poll<<F as Future>::Output>

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