Struct orx_concurrent_iter::ConIterOfIter

pub struct ConIterOfIter<T: Send + Sync, Iter>
where
    Iter: Iterator<Item = T>,
{ /* private fields */ }

A regular Iter: Iterator ascended to the concurrent programs with use of atomics.

Since ConIterOfIter can wrap up any Iterator and enable concurrent iteration, it might be considered as the most general ConcurrentIter implementation.

In performance critical scenarios and whenever possible, it might be preferable to use a more specific implementation such as crate::ConIterOfSlice.

Implementations

impl<T: Send + Sync, Iter> ConIterOfIter<T, Iter>

where Iter: Iterator<Item = T>,

pub fn new(iter: Iter) -> Self

Creates a concurrent iterator for the given iter.

Trait Implementations

impl<T: Send + Sync, Iter> AtomicIter<T> for ConIterOfIter<T, Iter>

where Iter: Iterator<Item = T>,

fn counter(&self) -> &AtomicCounter

Returns a reference to the underlying advanced item counter.

fn get(&self, item_idx: usize) -> Option<T>

Returns the item_idx-th item that the iterator yields; returns None if the iterator completes before.

fn fetch_n(&self, n: usize) -> impl NextChunk<T>

Returns an iterator of the next n consecutive items that the iterator yields. It might return an iterator of less or no items if the iteration does not have sufficient elements left.

fn for_each_n<F: FnMut(T)>(&self, chunk_size: usize, f: F)

Applies the function f to each element of the iterator concurrently.

fn enumerate_for_each_n<F: FnMut(usize, T)>(&self, chunk_size: usize, f: F)

Applies the function f to each element and its corresponding index of the iterator concurrently. It may be considered as the concurrent counterpart of the chain of enumerate and for_each_n calls.

fn fold<B, F: FnMut(B, T) -> B>(&self, chunk_size: usize, initial: B, f: F) -> B

Folds the elements of the iterator pulled concurrently using fold function.

fn fetch_one(&self) -> Option<Next<T>>

Returns the next item that the iterator yields; returns None if the iteration has completed.

impl<T: Send + Sync, Iter> ConcurrentIter for ConIterOfIter<T, Iter>

where Iter: Iterator<Item = T>,

type Item = T

Type of the items that the iterator yields.

fn next_id_and_value(&self) -> Option<Next<Self::Item>>

Advances the iterator and returns the next value together with its enumeration index.

fn next_chunk(&self, chunk_size: usize) -> impl NextChunk<Self::Item>

Advances the iterator chunk_size times and returns an iterator of at most chunk_size consecutive next values. Further, the beginning enumeration index of the yielded values is returned.

fn for_each_n<F: FnMut(Self::Item)>(&self, chunk_size: usize, f: F)

Applies the function fun to each element of the iterator concurrently.

fn enumerate_for_each_n<F: FnMut(usize, Self::Item)>( &self, chunk_size: usize, f: F )

Applies the function fun to each index and corresponding element of the iterator concurrently.

fn fold<B, Fold>(&self, chunk_size: usize, neutral: B, fold: Fold) -> B

where Fold: FnMut(B, Self::Item) -> B,

Folds the elements of the iterator pulled concurrently using fold function.

fn try_get_len(&self) -> Option<usize>

Returns Some of the remaining length of the iterator if it is known; returns None otherwise.

fn next(&self) -> Option<Self::Item>

Advances the iterator and returns the next value.

fn values(&self) -> ConIterValues<'_, Self>

where Self: Sized,

Returns an Iterator over the values of elements of the concurrent iterator.

fn ids_and_values(&self) -> ConIterIdsAndValues<'_, Self>

where Self: Sized,

Returns an Iterator over the ids and values of elements of the concurrent iterator.

fn for_each<Fun: FnMut(Self::Item)>(&self, fun: Fun)

Applies the function fun to each element of the iterator concurrently.

fn enumerate_for_each<Fun: FnMut(usize, Self::Item)>(&self, fun: Fun)

Applies the function fun to each index and corresponding element of the iterator concurrently. It may be considered as the concurrent counterpart of the chain of enumerate and for_each calls.

impl<T: Debug + Send + Sync, Iter> Debug for ConIterOfIter<T, Iter>

where Iter: Iterator<Item = T> + Debug,

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

Formats the value using the given formatter.

impl<T: Send + Sync, Iter> From<Iter> for ConIterOfIter<T, Iter>

where Iter: Iterator<Item = T>,

fn from(iter: Iter) -> Self

Converts to this type from the input type.

impl<T: Send + Sync, Iter> Send for ConIterOfIter<T, Iter>

where Iter: Iterator<Item = T>,

impl<T: Send + Sync, Iter> Sync for ConIterOfIter<T, Iter>

where Iter: Iterator<Item = T>,