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

use std::num::NonZero;

use crate::{
    buffer,
    buffer::{
        segments,
        segments::{chain::edit, handles},
    },
};

/// One remaining owner retaining its original pooled node.
#[repr(transparent)]
pub struct Single<T: buffer::raw::Segment>(segments::Chain<T>);

impl<T: buffer::raw::Segment> Single<T> {
    /// # Safety
    /// The chain owns exactly one live node in the single state.
    pub(in crate::buffer::segments::chain) const unsafe fn new(chain: segments::Chain<T>) -> Self {
        Self(chain)
    }

    pub fn len(&self) -> NonZero<usize> {
        buffer::raw::Unary::item(self).len()
    }

    pub(in crate::buffer::segments::chain) fn into_item(self) -> segments::Item<T> {
        let mut sequence = self.0;
        // SAFETY: Single owns this sole node until it is consumed.
        let index = unsafe { sequence.key.single_index() };
        edit::Single {
            sequence: &mut sequence,
            index,
        }
        .take()
    }
}

impl<T: buffer::raw::Segment> buffer::raw::Unary<T> for Single<T> {
    fn item(&self) -> &segments::Item<T> {
        let sequence = &self.0;
        // SAFETY: Single retains its sole initialized node for this shared borrow.
        unsafe { handles::nodes(&sequence.handle).value(sequence.key.single_index()) }
    }
}

impl<T: buffer::raw::Segment> AsRef<T> for Single<T> {
    fn as_ref(&self) -> &T {
        buffer::raw::Unary::item(self).as_ref()
    }
}

impl<T: buffer::raw::Segment> buffer::Residency for Single<T> {
    fn resident(&self) -> usize {
        buffer::Residency::resident(buffer::raw::Unary::item(self))
    }
}

const _: () = {
    assert!(size_of::<Single<buffer::storage::Shared>>() == 2 * size_of::<usize>());
    assert!(
        size_of::<Option<Single<buffer::storage::Shared>>>()
            == size_of::<Single<buffer::storage::Shared>>()
    );
};