obcrypt 1.0.0

Bytes-in/bytes-out cryptographic core of the oboron protocol (authenticated core schemes, no encoding).
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

//! `aead::Buffer` adapter that views a tail-slice of an existing
//! `Vec<u8>` as a growable buffer.
//!
//! Used by per-scheme `*_into` functions so AEAD `encrypt_in_place` /
//! `decrypt_in_place` can write ciphertext directly into a caller-
//! provided buffer without an intermediate allocation.

use aead::Buffer;

pub(crate) struct TailBuffer<'a> {
    vec: &'a mut Vec<u8>,
    start: usize,
}

impl<'a> TailBuffer<'a> {
    #[inline]
    pub(crate) fn new(vec: &'a mut Vec<u8>, start: usize) -> Self {
        debug_assert!(start <= vec.len(), "TailBuffer start out of bounds");
        TailBuffer { vec, start }
    }
}

impl AsRef<[u8]> for TailBuffer<'_> {
    #[inline]
    fn as_ref(&self) -> &[u8] {
        &self.vec[self.start..]
    }
}

impl AsMut<[u8]> for TailBuffer<'_> {
    #[inline]
    fn as_mut(&mut self) -> &mut [u8] {
        &mut self.vec[self.start..]
    }
}

impl Buffer for TailBuffer<'_> {
    #[inline]
    fn extend_from_slice(&mut self, other: &[u8]) -> Result<(), aead::Error> {
        self.vec.extend_from_slice(other);
        Ok(())
    }

    #[inline]
    fn truncate(&mut self, len: usize) {
        self.vec.truncate(self.start + len);
    }
}