buffer 0.1.9

Safe, write-only, generics-free buffer abstraction
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

use Buffer;
use BufferRef;
use ToBufferRef;
use wildly_unsafe;

/// The intermediate step from a byte slice to a `BufferRef`.
pub struct SliceBuffer<'data> {
    slice: &'data mut [u8],
    initialized: usize,
}

impl<'d> SliceBuffer<'d> {
    fn new(slice: &'d mut [u8]) -> SliceBuffer<'d> {
        SliceBuffer {
            slice: slice,
            initialized: 0,
        }
    }
    fn buffer<'s>(&'s mut self) -> BufferRef<'d, 's> {
        unsafe {
            // This is unsafe, we now have two unique (mutable) references to
            // the same `Vec`. However, we will only access `self.vec.len`
            // through `self` and only the contents through the `BufferRef`.
            BufferRef::new(wildly_unsafe(self.slice), &mut self.initialized)
        }
    }
}

impl<'d> Buffer<'d> for &'d mut [u8] {
    type Intermediate = SliceBuffer<'d>;
    fn to_to_buffer_ref(self) -> Self::Intermediate {
        SliceBuffer::new(self)
    }
}

impl<'d> ToBufferRef<'d> for SliceBuffer<'d> {
    fn to_buffer_ref<'s>(&'s mut self) -> BufferRef<'d, 's> {
        self.buffer()
    }
}