barse 0.3.0

Binary parsing library.
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

use std::marker::PhantomData;

use crate::{error::Error, ByteRead, FromByteReader, Result};

/// Trait used to query the length of a vector.
pub trait VecLenQuery {
    /// Type to query on.
    type Flag;

    /// Length of items that should be in vector.
    fn len(flag: &Self::Flag) -> usize;
}

/// A vec with it's length queried from a reader.
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
pub struct SizedVec<T, Q>(Vec<T>, PhantomData<Q>);

impl<'input, T, Q, E> FromByteReader<'input> for SizedVec<T, Q>
where
    T: FromByteReader<'input, Err = E>,
    Q: VecLenQuery + 'static,
    E: From<Error>,
{
    type Err = E;

    fn from_byte_reader<R>(mut reader: R) -> Result<Self, Self::Err>
    where
        R: ByteRead<'input>,
    {
        let flag = reader.flag::<Q::Flag>()?;
        let len = Q::len(flag);
        let items = (0..len)
            .map(|_| T::from_byte_reader(&mut reader))
            .collect::<Result<Vec<_>, Self::Err>>()?;

        Ok(Self(items, PhantomData::default()))
    }
}

impl<T, Q> From<SizedVec<T, Q>> for Vec<T> {
    fn from(value: SizedVec<T, Q>) -> Self {
        value.0
    }
}