Struct ThreadPool

pub struct ThreadPool { /* private fields */ }

A general-purpose thread pool for scheduling asynchronous tasks.

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.

Implementations

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) -> Result<F::Item, F::Error>

Runs the given future with this thread pool as the default executor 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 executor 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 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 Debug for ThreadPool

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

Formats the value using the given formatter.

impl Drop for ThreadPool

fn drop(&mut self)

Executes the destructor for this type.

impl Executor for ThreadPool

fn spawn( &mut self, f: Box<dyn Future<Item = (), Error = Never> + Send>, ) -> Result<(), SpawnError>

Spawn the given task, polling it until completion.

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

Determine whether the executor is able to spawn new tasks.