vecdb 0.10.2

High-performance mutable persistent vectors built on rawdb
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

use crate::{Bytes, Error, Result, SIZE_OF_U64, Stamp};

/// Position-tracking reader for change-file payloads.
pub(crate) struct ChangeCursor<'a> {
    bytes: &'a [u8],
    pos: usize,
}

impl<'a> ChangeCursor<'a> {
    pub fn new(bytes: &'a [u8]) -> Self {
        Self { bytes, pos: 0 }
    }

    pub fn read_u64(&mut self) -> Result<usize> {
        self.check_remaining(SIZE_OF_U64)?;
        let v = usize::from_bytes(&self.bytes[self.pos..self.pos + SIZE_OF_U64])?;
        self.pos += SIZE_OF_U64;
        Ok(v)
    }

    pub fn read_stamp(&mut self) -> Result<Stamp> {
        self.check_remaining(SIZE_OF_U64)?;
        let v = Stamp::from_bytes(&self.bytes[self.pos..self.pos + SIZE_OF_U64])?;
        self.pos += SIZE_OF_U64;
        Ok(v)
    }

    pub fn skip(&mut self, n: usize) -> Result<()> {
        self.check_remaining(n)?;
        self.pos += n;
        Ok(())
    }

    pub fn read_values<T, F: FnMut(&[u8]) -> Result<T>>(
        &mut self,
        count: usize,
        size_of_t: usize,
        mut read: F,
    ) -> Result<Vec<T>> {
        let total = size_of_t.checked_mul(count).ok_or(Error::Overflow)?;
        self.check_remaining(total)?;
        let vals = self.bytes[self.pos..self.pos + total]
            .chunks(size_of_t)
            .map(&mut read)
            .collect::<Result<Vec<_>>>()?;
        self.pos += total;
        Ok(vals)
    }

    fn check_remaining(&self, len: usize) -> Result<()> {
        let end = self.pos.checked_add(len).ok_or(Error::Overflow)?;
        if end > self.bytes.len() {
            return Err(Error::WrongLength {
                received: self.bytes.len(),
                expected: end,
            });
        }
        Ok(())
    }
}