better_collect 0.5.0-deprecated

Provides a composable, declarative way to consume an iterator
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
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

use super::{CollectorBase, IntoCollectorBase};

/// A type that can be converted into a collector by shared reference.
///
/// This trait's main purpose is to provide a convenience method to creates
/// a collector from `&T`.
///
/// You cannot implement this trait directly.
/// Instead, you should implement [`IntoCollectorBase`] for `&T`
/// (where `T` is your type)
/// and this trait is automatically implemented for `T`.
///
/// This trait is not intended for use in bounds.
/// Use [`IntoCollector`] or [`IntoCollectorBase`] in trait bounds instead.
///
/// [`IntoCollector`]: super::IntoCollector
#[allow(private_bounds)]
pub trait CollectorByRef: Sealed {
    /// Which collector being produced?
    type Collector<'a>: CollectorBase
    where
        Self: 'a;

    /// Creates a collector from a shared reference of a value.
    fn collector(&self) -> Self::Collector<'_>;
}

impl<T> CollectorByRef for T
where
    T: ?Sized,
    for<'a> &'a T: IntoCollectorBase,
{
    type Collector<'a>
        = <&'a T as IntoCollectorBase>::IntoCollector
    where
        T: 'a;

    #[inline]
    fn collector(&self) -> Self::Collector<'_> {
        self.into_collector()
    }
}

trait Sealed {}

impl<T> Sealed for T
where
    T: ?Sized,
    for<'a> &'a T: IntoCollectorBase,
{
}