flatk 0.5.2

Flat layout abstraction toolkit.
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
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89

/// A marker trait to indicate a viewed collection type. Note that collections
/// can be partially viewed, but only completely viewed collections are marked
/// by `Viewed`.
pub trait Viewed {}

/// A trait defining a collection that can be accessed via an
/// immutable (shared) view. This type of view can be cloned and copied.
pub trait View<'a> {
    type Type: Viewed;

    fn view(&'a self) -> Self::Type;
}

/// A trait defining a collection that can be accessed via a mutable (unique)
/// view.
pub trait ViewMut<'a> {
    type Type: Viewed;

    fn view_mut(&'a mut self) -> Self::Type;
}

/// Blanket implementation of `View` for all immutable borrows.
impl<'a, S: ?Sized + 'a + View<'a>> View<'a> for &S {
    type Type = S::Type;

    #[inline]
    fn view(&'a self) -> Self::Type {
        <S as View<'a>>::view(*self)
    }
}

/// Blanket implementation of `View` for all mutable borrows.
impl<'a, S: ?Sized + 'a + View<'a>> View<'a> for &mut S {
    type Type = S::Type;

    #[inline]
    fn view(&'a self) -> Self::Type {
        <S as View<'a>>::view(*self)
    }
}

/// Blanket implementation of `ViewMut` for all mutable borrows.
impl<'a, S: ?Sized + 'a + ViewMut<'a>> ViewMut<'a> for &mut S {
    type Type = S::Type;

    #[inline]
    fn view_mut(&'a mut self) -> Self::Type {
        <S as ViewMut<'a>>::view_mut(*self)
    }
}

pub trait IntoView {
    type View;
    fn into_view(self) -> Self::View;
}

impl<'a, V: View<'a>> IntoView for &'a V {
    type View = V::Type;
    #[inline]
    fn into_view(self) -> Self::View {
        self.view()
    }
}

impl<'a, V: ViewMut<'a>> IntoView for &'a mut V {
    type View = V::Type;
    #[inline]
    fn into_view(self) -> Self::View {
        self.view_mut()
    }
}

/// A convenience trait to allow generic implementations to call an iterator over the view. This
/// is necessary because the `View` trait has an explicit lifetime parameter, which makes it
/// difficult or impossible to use in generic functions.
/// For instance it becomes difficult/impossible to impose constraints like `Set` on `View::Type`.
pub trait ViewIterator<'a> {
    type Item;
    type Iter: Iterator<Item = Self::Item>;

    fn view_iter(&'a self) -> Self::Iter;
}

pub trait ViewMutIterator<'a> {
    type Item;
    type Iter: Iterator<Item = Self::Item>;

    fn view_mut_iter(&'a mut self) -> Self::Iter;
}