Struct easy_parallel::Parallel
source · [−]pub struct Parallel<'a, T> { /* private fields */ }
Expand description
A builder that runs closures in parallel.
Implementations
sourceimpl<'a, T> Parallel<'a, T>
impl<'a, T> Parallel<'a, T>
sourcepub fn new() -> Parallel<'a, T>
pub fn new() -> Parallel<'a, T>
Creates a builder for running closures in parallel.
Examples
use easy_parallel::Parallel;
let p = Parallel::<()>::new();
sourcepub fn add<F>(self, f: F) -> Parallel<'a, T> where
F: FnOnce() -> T + Send + 'a,
T: Send + 'a,
pub fn add<F>(self, f: F) -> Parallel<'a, T> where
F: FnOnce() -> T + Send + 'a,
T: Send + 'a,
Adds a closure to the list.
Examples
use easy_parallel::Parallel;
Parallel::new()
.add(|| println!("hello from a thread"))
.run();
sourcepub fn each<A, I, F>(self, iter: I, f: F) -> Parallel<'a, T> where
I: IntoIterator<Item = A>,
F: FnOnce(A) -> T + Clone + Send + 'a,
A: Send + 'a,
T: Send + 'a,
pub fn each<A, I, F>(self, iter: I, f: F) -> Parallel<'a, T> where
I: IntoIterator<Item = A>,
F: FnOnce(A) -> T + Clone + Send + 'a,
A: Send + 'a,
T: Send + 'a,
Adds a cloned closure for each item in an iterator.
Each clone of the closure takes an item as an argument.
Examples
use easy_parallel::Parallel;
Parallel::new()
.each(0..5, |i| println!("hello from thread #{}", i))
.run();
sourcepub fn run(self) -> Vec<T> where
T: Send + 'a,
pub fn run(self) -> Vec<T> where
T: Send + 'a,
Runs each closure on a separate thread and collects their results.
Results are collected in the order in which closures were added. One of the closures always runs on the main thread because there is no point in spawning an extra thread for it.
If a closure panics, panicking will resume in the main thread after all threads are joined.
Examples
use easy_parallel::Parallel;
use std::thread;
use std::time::Duration;
let res = Parallel::new()
.each(1..=3, |i| 10 * i)
.add(|| 100)
.run();
assert_eq!(res, [10, 20, 30, 100]);
sourcepub fn finish<F, R>(self, f: F) -> (Vec<T>, R) where
F: FnOnce() -> R,
T: Send + 'a,
pub fn finish<F, R>(self, f: F) -> (Vec<T>, R) where
F: FnOnce() -> R,
T: Send + 'a,
Finishes with a closure to run on the main thread, starts threads, and collects results.
Results are collected in the order in which closures were added.
If a closure panics, panicking will resume in the main thread after all threads are joined.
Examples
use easy_parallel::Parallel;
use std::thread;
use std::time::Duration;
let (res, ()) = Parallel::new()
.each(1..=3, |i| 10 * i)
.finish(|| println!("Waiting for results"));
assert_eq!(res, [10, 20, 30]);
Trait Implementations
Auto Trait Implementations
impl<'a, T> !RefUnwindSafe for Parallel<'a, T>
impl<'a, T> Send for Parallel<'a, T>
impl<'a, T> !Sync for Parallel<'a, T>
impl<'a, T> Unpin for Parallel<'a, T>
impl<'a, T> !UnwindSafe for Parallel<'a, T>
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more