Struct Reader 

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

A cursor over a byte slice with checked little-endian reads.

Implementations

impl<'a> Reader<'a>

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

A reader that reports truncation as Check::DirChunkExtent.

Callers parsing a specific structure should prefer Reader::checked.

pub fn checked(buf: &'a [u8], check: Check) -> Self

A reader whose truncation errors report check.

pub fn with_check(self, check: Check) -> Self

The same reader with a different truncation check.

pub fn check(&self) -> Check

The check reported when a read runs past the end.

pub fn pos(&self) -> usize

Bytes consumed so far.

pub fn remaining(&self) -> usize

Bytes left.

pub fn is_empty(&self) -> bool

Whether the reader is exhausted.

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

The whole underlying buffer.

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

The not-yet-consumed tail.

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

Read one byte.

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

Read a u16.

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

Read a u32.

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

Read a u64.

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

Read a fixed-size array.

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

Borrow the next n bytes.

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

Borrow the whole tail.

pub fn skip(&mut self, n: usize) -> Result<()>

Skip n bytes.

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

Read a varint (section 5.2).

pub fn varint_bounded(&mut self, max: u64) -> Result<u64>

Read a varint bounded by max, rejecting a value above it before allocation.

pub fn utf8(&mut self, n: usize) -> Result<&'a str>

Read a UTF-8 string of n bytes.

Trait Implementations

impl<'a> Clone for Reader<'a>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Reader<'a>

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

Formats the value using the given formatter.