Struct Cursor 

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

顺序读取小端序整数的游标。

每个方法都做边界检查并返回结构化错误，避免 panic —— 解析不可信输入时这点很重要。

Implementations

impl<'a> Cursor<'a>

pub const fn new(data: &'a [u8], context: &'static str) -> Self

新建游标。

pub const fn position(&self) -> usize

当前偏移量。

pub const fn remaining(&self) -> usize

剩余字节数。

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

跳过 n 字节。

Errors

剩余不足时返回 Error::Truncated。

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

取出 n 字节切片。

Errors

剩余不足时返回 Error::Truncated。

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

取出固定长度数组。

Errors

剩余不足时返回 Error::Truncated。

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

读 u8。

Errors

剩余不足时返回 Error::Truncated。

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

读小端序 u16。

Errors

剩余不足时返回 Error::Truncated。

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

读小端序 u32。

Errors

剩余不足时返回 Error::Truncated。

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

读小端序 u64。

Errors

剩余不足时返回 Error::Truncated。