o3 0.22.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
57
58
59
60
61
62
63
64
65
66

use std::num::NonZero;

use crate::{
    buffer,
    buffer::segments::{
        queue,
        queue::{Fifo, Iter},
    },
};

// SAFETY: the iterator retains one immutable queue and its exact bounded range.
unsafe impl<'a, T: buffer::raw::Segment> buffer::raw::Scatter<'a> for Iter<'a, T> {
    fn remaining(&self) -> usize {
        self.remaining()
    }

    unsafe fn advance<const MAX: usize>(
        &mut self,
        cap: NonZero<usize>,
        left: NonZero<usize>,
    ) -> buffer::raw::Chunk<'a, MAX> {
        // SAFETY: the raw cursor contract supplies the exact bounds for this
        // borrowed state; Step retains them until the physical read completes.
        unsafe { self.next_chunk(cap, left) }
    }
}

unsafe impl<T: buffer::raw::Segment> buffer::raw::Chunks for queue::Slice<'_, T> {
    type Cursor<'data>
        = queue::Iter<'data, T>
    where
        Self: 'data;

    fn len(&self) -> usize {
        self.len()
    }

    fn start(&self) -> Self::Cursor<'_> {
        self.fragments()
    }

    fn cursor(&self, offset: usize) -> Option<Self::Cursor<'_>> {
        self.get(offset..self.len())
            .map(<queue::Slice<'_, T>>::fragments)
    }
}

unsafe impl<T: buffer::raw::Segment> buffer::raw::Chunks for Fifo<T> {
    type Cursor<'data>
        = queue::Iter<'data, T>
    where
        Self: 'data;

    fn len(&self) -> usize {
        self.len()
    }

    fn start(&self) -> Self::Cursor<'_> {
        self.fragments()
    }

    fn cursor(&self, offset: usize) -> Option<Self::Cursor<'_>> {
        self.get(offset..self.len())
            .map(<queue::Slice<'_, T>>::fragments)
    }
}