Struct futures_executor::ThreadPool

[+] Show declaration

pub struct ThreadPool { /* fields omitted */ }

[−] Expand description

A general-purpose thread pool for scheduling tasks that poll futures to completion.

The thread pool multiplexes any number of tasks onto a fixed number of worker threads.

This type is a clonable handle to the threadpool itself. Cloning it will only create a new reference, not a new threadpool.

Methods

impl ThreadPool

[−]

pub fn new() -> Result<ThreadPool, Error>

[−]

Creates a new thread pool with the default configuration.

See documentation for the methods in ThreadPoolBuilder for details on the default configuration.

pub fn builder() -> ThreadPoolBuilder

[−]

Create a default thread pool configuration, which can then be customized.

See documentation for the methods in ThreadPoolBuilder for details on the default configuration.

pub fn run<F: Future>(&mut self, f: F) -> F::Output

[−]

Runs the given future with this thread pool as the default spawner for spawning tasks.

This function will block the calling thread until the given future is complete. While executing that future, any tasks spawned onto the default spawner will be routed to this thread pool.

Note that the function will return when the provided future completes, even if some of the tasks it spawned are still running.

Trait Implementations

impl Debug for ThreadPool

[+]

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

[−]

Formats the value using the given formatter.

impl Spawn for ThreadPool

[+]

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

[−]

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

futures in libcore are unstable

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

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

[−]

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

futures in libcore are unstable

Determines whether the executor is able to spawn new tasks.

impl Clone for ThreadPool

[+]

fn clone(&self) -> ThreadPool

[−]

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

[−]

Performs copy-assignment from source.

impl Drop for ThreadPool

[+]

fn drop(&mut self)

[−]

Executes the destructor for this type.