futures_util::task

Trait Spawn

source
pub trait Spawn {
    // Required method
    fn spawn_obj(
        &self,
        future: FutureObj<'static, ()>,
    ) -> Result<(), SpawnError>;

    // Provided method
    fn status(&self) -> Result<(), SpawnError> { ... }
}
Expand description

The Spawn trait allows for pushing futures onto an executor that will run them to completion.

Required Methods§

source

fn spawn_obj(&self, future: FutureObj<'static, ()>) -> Result<(), SpawnError>

Spawns a future that will be run to completion.

§Errors

The executor may be unable to spawn tasks. Spawn errors should represent relatively rare scenarios, such as the executor having been shut down so that it is no longer able to accept tasks.

Provided Methods§

source

fn status(&self) -> Result<(), SpawnError>

Determines whether the executor is able to spawn new tasks.

This method will return Ok when the executor is likely (but not guaranteed) to accept a subsequent spawn attempt. Likewise, an Err return means that spawn is likely, but not guaranteed, to yield an error.

Implementations on Foreign Types§

source§

impl<Sp> Spawn for &Sp
where Sp: Spawn + ?Sized,

source§

fn spawn_obj(&self, future: FutureObj<'static, ()>) -> Result<(), SpawnError>

source§

fn status(&self) -> Result<(), SpawnError>

source§

impl<Sp> Spawn for &mut Sp
where Sp: Spawn + ?Sized,

source§

fn spawn_obj(&self, future: FutureObj<'static, ()>) -> Result<(), SpawnError>

source§

fn status(&self) -> Result<(), SpawnError>

source§

impl<Sp> Spawn for Box<Sp>
where Sp: Spawn + ?Sized,

source§

fn spawn_obj(&self, future: FutureObj<'static, ()>) -> Result<(), SpawnError>

source§

fn status(&self) -> Result<(), SpawnError>

source§

impl<Sp> Spawn for Rc<Sp>
where Sp: Spawn + ?Sized,

source§

fn spawn_obj(&self, future: FutureObj<'static, ()>) -> Result<(), SpawnError>

source§

fn status(&self) -> Result<(), SpawnError>

source§

impl<Sp> Spawn for Arc<Sp>
where Sp: Spawn + ?Sized,

source§

fn spawn_obj(&self, future: FutureObj<'static, ()>) -> Result<(), SpawnError>

source§

fn status(&self) -> Result<(), SpawnError>

Implementors§

source§

impl Spawn for FuturesUnordered<FutureObj<'_, ()>>

source§

impl<Ex> Spawn for Executor01As03<Ex>
where Ex: Executor01<Executor01Future> + Clone + Send + 'static,

Available on crate feature compat only.