Struct Reader 

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

A buffer values are read from.

Implementations

impl<'a> Reader<'a>

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

Reads values from a borrowed buffer without copying it.

pub fn rest(&self) -> &'a [u8]

The bytes not yet read.

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

Takes exactly len bytes, refusing a length beyond the remaining buffer.

pub fn take_len(&mut self, min: usize) -> Result<usize, WireError>

A length read before items values of at least min bytes each: refused when the rest of the buffer could not hold them, so no allocation outruns its input.

pub fn take<T>(&mut self) -> Result<T, WireError>

where T: Wire,

Decodes one value from the current position.

pub fn bounded<T>( &mut self, max_bytes: usize, read: impl FnOnce(&mut Reader<'a>) -> Result<T, WireError>, ) -> Result<T, WireError>

Read one value from at most max_bytes, preserving the enclosing reader’s depth and leaving the following value untouched. No nested allocation can outrun this byte window.

pub fn list_with<T>( &mut self, max_items: usize, read: impl FnMut(&mut Reader<'a>) -> Result<T, WireError>, ) -> Result<Vec<T>, WireError>

where T: Wire,

A normal Wire list, with its element cap checked before allocating storage. read may impose a shared payload budget across its elements without a second list codec.

pub fn nested<T>( &mut self, read: impl FnOnce(&mut Reader<'a>) -> Result<T, WireError>, ) -> Result<T, WireError>

Reads one level down: the depth the value may nest to is MAX_DEPTH.

pub fn decode<T>(data: &'a [u8]) -> Result<T, WireError>

where T: Wire,

The whole of data as one T.