Struct Cursor 

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

A cursor over a byte slice, tracking the current read position.

Implementations

impl<'a> Cursor<'a>

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

Create a new cursor at position 0.

pub fn position(&self) -> usize

Current byte offset.

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

Remaining bytes.

pub fn capacity_hint(&self, count: u32) -> usize

Pre-allocation capacity for count entries yet to be parsed.

Malformed binaries can declare counts in the billions; blindly trusting them in Vec::with_capacity turns a tiny input into a multi-gigabyte allocation. Every entry needs at least one byte in the stream, so the remaining input length is a sound upper bound.

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

Original backing slice.

pub fn is_empty(&self) -> bool

Whether we’ve consumed all input.

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

Read a single byte, advancing the cursor.

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

Read exactly n bytes as a slice, advancing the cursor.

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

Advance the cursor by n bytes.

Trait Implementations

impl<'a> Debug for Cursor<'a>

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

Formats the value using the given formatter.