A flexible thread pool providing scoped and static threads.
Example of simple use (applying a transformation to every item in an array):
extern crate scoped_pool;
use scoped_pool::Pool;
let pool = Pool::new(4);
let mut buf = [0, 0, 0, 0];
pool.scoped(|scope| {
for i in &mut buf {
scope.execute(move || *i += 1);
}
});
assert_eq!(&buf, &[1, 1, 1, 1]);Besides the core API used above (Pool::new, Pool::scoped) this crate also
provides many extremely useful convenience functions for complex code using
scoped threads.
Also includes the raw WaitGroup type, which can be used to implement similar
"wait for a group of actions to complete" logic, and is used in Pool and
Scope.
See the generated documentation (linked above) for details.
Unlike many other scoped threadpool crates, this crate is designed to be
maximally flexible: Pool and Scope are both Send + Sync, Pool is Clone,
and both have many useful conveniences such as:
Pool::spawn for spawning 'static jobs.
Pool::expand for expanding the number of threads in the pool.
Pool::shutdown for shutting down the pool.
Scope::forever and Scope::zoom for externalizing Scope management and
allowing fine-grained control over when jobs are scheduled and waited on.
Nearly all methods on both types require only an immutable borrow, and thus are safe to use concurrently without external synchronization.
In addition, the internal design of this crate is carefully constructed so that
all unsafety is encapsulated in the Scope type, which effectively just adds
lifetime scoping to the WaitGroup type for jobs scheduled on a Pool.
Use the crates.io repository; add this to your Cargo.toml along
with the rest of your dependencies:
[dependencies]
scoped-pool = "1"Jonathan Reem is the primary author and maintainer of scoped-pool.
MIT