o3 0.24.0

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

use std::{marker, ops};

use crate::buffer::{self, bytes::scope};

/// Bounds selected from the immutable owner with this invariant identity.
#[derive(Debug)]
pub struct Range<'id> {
    pub(in crate::buffer::bytes::scope) bounds: ops::Range<usize>,
    pub(in crate::buffer::bytes::scope) brand: marker::PhantomData<*mut &'id ()>,
}

impl<'id> Range<'id> {
    pub(in crate::buffer::bytes::scope) fn new(
        source: scope::View<'_, 'id>,
        bounds: ops::Range<usize>,
    ) -> Self {
        Self {
            bounds,
            brand: source.brand,
        }
    }

    /// Selects one side of the unchanged source's admitted prefix boundary.
    pub(in crate::buffer) fn select<const SUFFIX: bool, S: buffer::raw::Store>(
        selected: buffer::raw::Selection<'id, S>,
    ) -> buffer::raw::Slice<'id, 'id, S> {
        let (source, len) = selected.into_parts();
        let bounds = if SUFFIX {
            len..source.as_ref().len()
        } else {
            0..len
        };
        let range = Self {
            bounds,
            brand: marker::PhantomData,
        };
        // SAFETY: the selected prefix retains this exact source and its admitted bounds.
        unsafe { buffer::raw::Slice::from_parts(source, range) }
    }
}

impl Range<'_> {
    pub(in crate::buffer) fn into_inner(self) -> ops::Range<usize> {
        self.bounds
    }

    pub fn is_empty(&self) -> bool {
        self.len() == 0
    }

    pub fn len(&self) -> usize {
        self.bounds.end - self.bounds.start
    }
}

const _: () = assert!(size_of::<Range<'static>>() == 2 * size_of::<usize>());