Struct Reader 

pub struct Reader<R> { /* private fields */ }

Struct used in [storekey::Decode] for reading types from the buffer.

This type handles unescaping bytes the buffer mostly transparently. It has an internal flag for marking when an escaped byte can be read from the buffer. Reading from the buffer in any way unmarks this flag.

Implementations

impl<R: BufRead> Reader<R>

pub const fn new(r: R) -> Self

Create a new reader.

pub fn is_empty(&mut self) -> Result<bool, DecodeError>

Returns if the reader is empty / contains no more data.

pub fn expect_escaped(&mut self)

Mark the next byte as possibly containing an escaped bytes.

pub fn read_terminal(&mut self) -> Result<bool, DecodeError>

Try to read a terminator byte if there is one.

Returns true if the next byte is a terminator, otherwise returns false and the reader does not advance.

Sets the expect_escaped flag marking the next byte as being possibly escaped.

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

Reads an fixed size array of u8 from the reader, unescaping possible escaped bytes.

All other read_* functions of Reader which read a fixed size type call this function to read a certain amount of bytes from the reader.

This type does not expect a null terminator after the end of the array as it is reading a fixed size type.

Calling this function unsets the expected escape flag before returning.

pub fn read_vec(&mut self) -> Result<Vec<u8>, DecodeError>

Reads a runtime sized Vec<u8> from the reader, expected the sequence of bytes to be ended by a terminal zero byte.

Calling this function unsets the expected escape flag before returning.

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

Reads a runtime sized String from the reader, expected the sequence of bytes to be ended by a terminal zero byte.

Calling this function unsets the expected escape flag before returning.

pub fn read_f32(&mut self) -> Result<f32, DecodeError>

pub fn read_f64(&mut self) -> Result<f64, DecodeError>

pub fn read_i8(&mut self) -> Result<i8, DecodeError>

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

pub fn read_i16(&mut self) -> Result<i16, DecodeError>

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

pub fn read_i32(&mut self) -> Result<i32, DecodeError>

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

pub fn read_i64(&mut self) -> Result<i64, DecodeError>

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

pub fn read_i128(&mut self) -> Result<i128, DecodeError>

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