bitstream-io 4.10.0

Library for reading/writing un-aligned values from/to streams in big-endian and little-endian formats.
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

pub trait ByteSource: Sized {
    type Error: Sized;

    #[inline(always)]
    fn read_byte(&mut self) -> Result<u8, Self::Error> {
        let mut byte = 0;
        self.read_bytes(core::slice::from_mut(&mut byte))
            .map(|()| byte)
    }

    fn read_bytes(&mut self, buf: &mut [u8]) -> Result<(), Self::Error>;

    fn skip_bytes(&mut self, bytes: u32) -> Result<(), Self::Error> {
        fn skip_chunks<const SIZE: usize, R>(
            reader: &mut R,
            mut bytes: usize,
        ) -> Result<(), R::Error>
        where
            R: ByteSource,
        {
            let mut buf = [0; SIZE];
            while bytes > 0 {
                let to_read = bytes.min(SIZE);
                reader.read_bytes(&mut buf[0..to_read])?;
                bytes -= to_read;
            }
            Ok(())
        }

        match bytes {
            0..256 => skip_chunks::<8, Self>(self, bytes as usize),
            256..1024 => skip_chunks::<256, Self>(self, bytes as usize),
            1024..4096 => skip_chunks::<1024, Self>(self, bytes as usize),
            _ => skip_chunks::<4096, Self>(self, bytes as usize),
        }
    }
}