Struct Splitter

pub struct Splitter { /* private fields */ }

Memorizes random assignment of indices to groups.

Implementations

impl Splitter

pub fn new<R: Rng + ?Sized>( rng: &mut R, source_len: usize, group_count: usize, ) -> Self

Randomly assign indices to fixed number of groups.

Create a Splitter struct, by randomly assigning indices (from 0..source_len) to a fixed number of groups (group_count). The returned struct provides access to the created groups (containing their assigned indices, see groups) and allows merging of iterators (see merge). If group_count is smaller than source_len, the number of groups is set (i.e. limited) to input_len.

pub fn assignments(&self) -> &[usize]

Return slice containing index of assigned group for each original index.

pub fn groups(&self) -> &[impl Deref<Target = [usize]>]

Return slice containing indices of created groups.

pub fn merge<'a, T, I, R>(&'a self, results: R) -> impl 'a + Iterator<Item = T>

where I: Iterator<Item = T> + 'a, R: BorrowMut<[I]> + 'a,

Merge iterators returning results for each group to a single iterator.

Trait Implementations

impl Debug for Splitter

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

Formats the value using the given formatter.