std::task::Executor - Rust
Description: API documentation for the Rust `Executor` trait in crate `std`.
Keywords: rust, rustlang, rust-lang, Executor

# Trait std::task::Executor[−][src]

    pub trait Executor {
        fn spawn_obj(
            &mut self,
            future: FutureObj<'static, ()>
        ) -> Result<(), SpawnObjError>;

        fn status(&self) -> Result<(), SpawnErrorKind> { ... }
    }

🔬 This is a nightly-only experimental API. (`futures_api` #50547)

futures in libcore are unstable

A task executor.

Futures are polled until completion by tasks, a kind of lightweight "thread". A task executor is responsible for the creation of these tasks and the coordination of their execution on real operating system threads. In particular, whenever a task signals that it can make further progress via a wake-up notification, it is the responsibility of the task executor to put the task into a queue to continue executing it, i.e. polling the future in it, later.

## Required Methods

### `fn spawn_obj(
&mut self,
future: FutureObj<'static, ()>
) -> Result<(), SpawnObjError>`

🔬 This is a nightly-only experimental API. (`futures_api` #50547)

futures in libcore are unstable

Spawns a new task with the given future. The future will be polled until completion.

# Errors

The executor may be unable to spawn tasks, either because it has been shut down or is resource-constrained.

## Provided Methods

### `fn status(&self) -> Result<(), SpawnErrorKind>`

🔬 This is a nightly-only experimental API. (`futures_api` #50547)

futures in libcore are unstable

Determines whether the executor is able to spawn new tasks.

# Returns

An `Ok` return means 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.

## Implementors

- `impl<E> Executor for Box<E> where E: Executor + ?Sized,` | [src]

# Help

## Keyboard Shortcuts

`?`
  Show this help dialog
`S`
  Focus the search field
`↑`
  Move up in search results
`↓`
  Move down in search results
`↹`
  Switch tab
`⏎`
  Go to active search result
`+`
  Expand all sections
`-`
  Collapse all sections

## Search Tricks

Prefix searches with a type followed by a colon (e.g. `fn:`) to restrict the search to a given type.

Accepted types are: `fn`, `mod`, `struct`, `enum`, `trait`, `type`, `macro`, and `const`.

Search functions by type signature (e.g. `vec -> usize` or `* -> vec`)

Search multiple things at once by splitting your query with comma (e.g. `str,u8` or `String,struct:Vec,test`)