o3 0.34.2

shared-nothing primitives
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
90
91
92
93
94
95

use std::{marker, pin::Pin};

use crate::depot::{
    arena::slab::{self, entries, external, storage},
    capacity,
};

pub(in crate::depot) type Inner<T, G, Tag> =
    slab::Pinned<external::Stamped<T, G>, Tag, 1, true, 1, storage::Lazy>;

pub struct Pinned<T, G: external::Generation, Tag = ()> {
    pub(in crate::depot) inner: Inner<T, G, Tag>,
    pub(in crate::depot) next: Option<G>,
}

pub type Anchor<'a, T, G, Tag = ()> = external::grant::Reservation<
    'a,
    slab::Anchor<'a, external::Stamped<T, G>, Tag, 1, true, 1, storage::Lazy>,
    G,
>;

pub type Anchored<'a, T, G, Tag = ()> = external::Occupied<
    slab::Anchored<'a, external::Stamped<T, G>, Tag, 1, true, 1, storage::Lazy>,
    Tag,
>;

impl<T, G: external::Generation, Tag> Pinned<T, G, Tag> {
    pub fn try_new(cap: capacity::Count) -> Result<Self, crate::alloc::Error> {
        Ok(Self {
            inner: slab::Pinned {
                core: entries::Core::try_new(cap)?,
                _pin: marker::PhantomPinned,
                tag: marker::PhantomData,
            },
            next: Some(G::INITIAL),
        })
    }

    pub fn capacity(&self) -> capacity::Count {
        storage::Plane::count(&self.inner.core.slots)
    }

    pub fn try_grant(self: Pin<&mut Self>) -> Result<Anchor<'_, T, G, Tag>, slab::Vacancy> {
        let (next, inner) = self.split();
        external::grant::Reservation::try_new(next, || inner.vacant())
    }

    pub fn try_occupied(
        self: Pin<&mut Self>,
        key: external::Key<G, Tag>,
    ) -> Result<Anchored<'_, T, G, Tag>, external::errors::Lookup<G, Tag>> {
        let owner = self.into_ref().get_ref();
        let entry = entries::Occupied::try_at(&owner.inner.core, key.index())
            .map_err(|cause| external::errors::Lookup::Physical { key, cause })?
            .take();
        let actual = entry.value().generation;
        if actual != key.generation() {
            return Err(external::errors::Lookup::Generation { key, actual });
        }
        Ok(external::Occupied {
            entry: slab::Anchored {
                entry,
                tag: marker::PhantomData,
            },
            tag: marker::PhantomData,
        })
    }
}

impl<'a, T, G: external::Generation, Tag> Anchor<'a, T, G, Tag> {
    pub fn index(&self) -> u32 {
        self.inner.index()
    }

    pub fn occupy(self, value: T) -> (external::Key<G, Tag>, Pin<&'a mut T>) {
        let (inner, generation) = self.issue();
        let key = external::Key::new(inner.index(), generation);
        let (_, value) = inner.occupy(external::Stamped { generation, value });
        (key, value.pinned())
    }
}

impl<'a, T, G: external::Generation, Tag> Anchored<'a, T, G, Tag> {
    pub fn value(&mut self) -> Pin<&mut T> {
        self.entry.value().pinned()
    }

    pub fn into_value(self) -> Pin<&'a mut T> {
        self.entry.into_value().pinned()
    }

    pub fn discard(self) {
        self.entry.discard();
    }
}