orx-concurrent-recursive-iter 2.0.0

A concurrent iterator that can be extended recursively by each of its items.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

trait Seal {}

/// Marker trait determining whether the iterator is exact-sized or not.
#[allow(private_bounds)]
pub trait Size: Seal + Send + Sync + Clone + Copy {
    /// Returns the total number of elements that the recursive iterator
    /// will generate if completely consumed.
    ///
    /// Returns None if this is not known ahead of time.
    fn exact_len(self) -> Option<usize>;
}

/// The iterator has known exact size.
#[derive(Clone, Copy)]
pub struct ExactSize(pub(super) usize);
impl Seal for ExactSize {}
impl Size for ExactSize {
    #[inline(always)]
    fn exact_len(self) -> Option<usize> {
        Some(self.0)
    }
}

/// Size of the iterator is unknown ahead of time.
#[derive(Clone, Copy)]
pub struct UnknownSize;
impl Seal for UnknownSize {}
impl Size for UnknownSize {
    #[inline(always)]
    fn exact_len(self) -> Option<usize> {
        None
    }
}