ps-ecc 0.1.0-8

Generates Reed-Solomon error correction codes.
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

use std::ops::Deref;

use ps_buffer::{Buffer, BufferError, SharedBuffer};

#[derive(Debug, Hash, PartialEq, Eq, PartialOrd, Ord)]
pub enum Cow<'lt> {
    Borrowed(&'lt [u8]),
    Owned(SharedBuffer),
}

impl Cow<'_> {
    /// This method turns this [`Cow`] into a [`Buffer`].
    /// - In the case of [`Cow::Borrowed`], a new [`Buffer`] is allocated.
    /// - In the case of [`Cow::Owned`], the existing [`Buffer`] is returned.
    /// # Errors
    /// [`BufferError`] is returned if an allocation error occurs.
    pub fn try_into_buffer(self) -> Result<SharedBuffer, BufferError> {
        match self {
            Cow::Borrowed(value) => Ok(Buffer::from_slice(value)?.share()),
            Cow::Owned(value) => Ok(value),
        }
    }
}

impl Deref for Cow<'_> {
    type Target = [u8];

    fn deref(&self) -> &Self::Target {
        match self {
            Self::Borrowed(value) => value,
            Self::Owned(value) => value,
        }
    }
}

impl<'lt> From<&'lt [u8]> for Cow<'lt> {
    fn from(value: &'lt [u8]) -> Self {
        Self::Borrowed(value)
    }
}

impl From<Buffer> for Cow<'_> {
    fn from(value: Buffer) -> Self {
        Self::Owned(value.share())
    }
}

impl From<SharedBuffer> for Cow<'_> {
    fn from(value: SharedBuffer) -> Self {
        Self::Owned(value)
    }
}