Struct BitReader 

pub struct BitReader<'a> { /* private fields */ }

An LSB-first bit reader over a VP8L bitstream (RFC 9649 §3.3).

Bits are pulled a byte at a time into a small accumulator and handed out least-significant-bit first. Running past the end of the input is reported as Error::InvalidInput rather than panicking, so a truncated stream fails cleanly.

Implementations

impl<'a> BitReader<'a>

pub fn new(data: &'a [u8]) -> Self

Creates a reader positioned at the start of data.

pub fn read_bits(&mut self, n: u32) -> Result<u32>

Reads n bits (0..=32) LSB-first, returning them right-aligned in a u32.

Reading 0 bits returns Ok(0) without consuming input (used by single-symbol prefix codes that encode no bits).

Errors

Returns Error::InvalidInput if fewer than n bits remain, or if n > 32.

pub fn read_bit(&mut self) -> Result<u32>

Reads a single bit (a convenience wrapper over read_bits).

Errors

Returns Error::InvalidInput if no bits remain.

pub fn bits_consumed(&self) -> usize

Total number of bits consumed so far.

pub fn is_exhausted(&self) -> bool

Whether every bit of the input has been consumed (the trailing partial byte, if any, is treated as zero padding and is not counted as remaining data).

Trait Implementations

impl<'a> Clone for BitReader<'a>

fn clone(&self) -> BitReader<'a>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a> Debug for BitReader<'a>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.