o3 0.26.1

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

use crate::{
    buffer,
    buffer::{pool, pool::owners, segments, storage},
    mem::rc,
};

#[repr(transparent)]
pub struct NonEmpty<'view, 'source, S: ?Sized>(&'view buffer::View<'source, S>);

impl<'view, 'source, S: ?Sized> NonEmpty<'view, 'source, S> {
    pub(in crate::buffer) fn new(view: &'view buffer::View<'source, S>) -> Option<Self> {
        if view.is_empty() {
            return None;
        }
        Some(Self(view))
    }

    /// # Safety
    /// The source-bound view exposes at least one byte.
    pub(in crate::buffer) unsafe fn assume(view: &'view buffer::View<'source, S>) -> Self {
        Self(view)
    }

    pub(in crate::buffer) fn as_slice(&self) -> &'source [u8] {
        self.0.as_slice()
    }

    pub(in crate::buffer) fn source(&self) -> &'source S {
        self.0.source()
    }

    pub(in crate::buffer) fn view(&self) -> &'view buffer::View<'source, S> {
        self.0
    }
}

impl<'view, 'source, S: ?Sized> From<&'view segments::Item<buffer::View<'source, S>>>
    for NonEmpty<'view, 'source, S>
{
    fn from(view: &'view segments::Item<buffer::View<'source, S>>) -> Self {
        Self(view.as_ref())
    }
}

impl<L> NonEmpty<'_, '_, storage::Shared<owners::Edge<owners::Plain<L>, pool::Borrowed<'_>>>> {
    pub(in crate::buffer) fn try_own(self) -> Result<storage::Shared, rc::Error> {
        Ok(self.0.try_clone()?.into_owner())
    }
}