Struct Decoder 

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

Parser for decoding values from a byte stream.

Decoder provides a cursor-based API for deserializing values encoded by Encoder. All integers are decoded from little-endian format.

Example

let mut dec = Decoder::new(&bytes);
let num = dec.read_u64()?;
let text = dec.read_string()?;
let flag = dec.read_bool()?;
dec.finish()?; // Verify all bytes consumed

Implementations

impl<'a> Decoder<'a>

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

Creates a new decoder from a byte slice.

pub fn remaining(&self) -> usize

Returns the number of unread bytes remaining.

pub fn read_array<const N: usize>(&mut self) -> Result<[u8; N]>

Reads a fixed-size byte array.

pub fn read_u8(&mut self) -> Result<u8>

Reads a u8 value.

pub fn read_u16(&mut self) -> Result<u16>

Reads a u16 value (little-endian).

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

Reads a u32 value (little-endian).

pub fn read_u64(&mut self) -> Result<u64>

Reads a u64 value (little-endian).

pub fn read_u128(&mut self) -> Result<u128>

Reads a u128 value (little-endian).

pub fn read_bool(&mut self) -> Result<bool>

Reads a boolean value (0 = false, 1 = true).

Returns an error if the byte is neither 0 nor 1.

pub fn read_raw(&mut self, len: usize) -> Result<&'a [u8]>

Reads exactly len raw bytes without a length prefix.

pub fn read_bytes(&mut self) -> Result<&'a [u8]>

Reads a byte slice with a u32 length prefix.

Format: [length: u32][data: bytes]

pub fn read_string(&mut self) -> Result<String>

Reads a UTF-8 string with a u32 length prefix.

Returns an error if the bytes are not valid UTF-8.

pub fn read_codec<T: BytesCodec>(&mut self) -> Result<T>

Reads a value that implements BytesCodec with a length prefix.

pub fn finish(self) -> Result<()>

Verifies that all bytes have been consumed.

Returns an error if there are unread bytes remaining. Use this at the end of decoding to ensure data integrity.

Example

let mut dec = Decoder::new(&bytes);
let value = dec.read_u64()?;
dec.finish()?; // Ensure no trailing bytes