Struct BinaryReader 

pub struct BinaryReader<R, E> { /* private fields */ }

二进制读取器，用于从实现了 ReadBytesExt trait 的类型中读取数据

这是一个泛型结构体，可以包装任何实现了 ReadBytesExt trait 的类型， 提供二进制数据的读取功能。

Implementations

impl<R, E> BinaryReader<R, E>

pub fn new(reader: R) -> Self

创建新的二进制读取器

Arguments

• lexer - 要读取的数据

Returns

返回新的 BinaryReader 实例

pub fn get_position(&self) -> u64

获取当前读取位置

Returns

返回当前的字节偏移位置

pub fn set_position(&mut self, position: u64) -> Result<u64, GaiaError>

where R: Seek,

设置读取位置

注意：如果底层reader不支持Seek操作，此函数将返回错误

Arguments

• pos - 新的读取位置

Returns

返回操作结果

pub fn finish(self) -> GaiaDiagnostics<R>

完成读取器并返回结果。

pub fn take_errors(&mut self) -> Vec<GaiaError>

获取并清空当前累积的错误列表。 该方法会返回所有在读取过程中遇到的错误，并重置内部的错误存储。

impl<R: ReadBytesExt, E: ByteOrder> BinaryReader<R, E>

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

读取 u8

Returns

返回读取的 u8 值或 IO 错误

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

读取 u16

Returns

返回读取的 u16 值或 IO 错误

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

读取 i16

Returns

返回读取的 i16 值或 IO 错误

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

读取 u32

Returns

返回读取的 u32 值或 IO 错误

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

读取 u64

Returns

返回读取的 u64 值或 IO 错误

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

读取 i32

Returns

返回读取的 i32 值或 IO 错误

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

读取 i64

Returns

返回读取的 i64 值或 IO 错误

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

读取 f32

Returns

返回读取的 f32 值或 IO 错误

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

读取 f64

Returns

返回读取的 f64 值或 IO 错误

pub fn read_bytes(&mut self, len: usize) -> Result<Vec<u8>>

读取指定长度的字节数组

Arguments

• len - 要读取的字节数

Returns

返回读取的字节数组或 IO 错误

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

读取固定长度的字节数组

Returns

返回读取的字节数组或 IO 错误

pub fn skip(&mut self, count: u64) -> Result<u64>

where R: Seek,

跳过指定数量的字节

注意：如果底层reader不支持Seek操作，此函数将返回错误

Arguments

• count - 要跳过的字节数

Returns

返回操作结果

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

读取 LEB128 编码的无符号 32 位整数

Returns

返回读取的 u32 值或 IO 错误

pub fn read_i32_leb128(&mut self) -> Result<i32>

读取 LEB128 编码的有符号 32 位整数

Returns

返回读取的 i32 值或 IO 错误

pub fn read_i64_leb128(&mut self) -> Result<i64>

读取 LEB128 编码的有符号 64 位整数

Returns

返回读取的 i64 值或 IO 错误

impl<R, E> BinaryReader<R, E>

pub fn leb128_size(value: u32) -> u32

计算 LEB128 编码值的字节长度（静态方法）

Arguments

• value - 要计算长度的值

Returns

返回编码后的字节长度

Trait Implementations

impl<R: Debug, E: Debug> Debug for BinaryReader<R, E>

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

Formats the value using the given formatter.

impl<R: Read, E> Read for BinaryReader<R, E>

fn read(&mut self, buffer: &mut [u8]) -> Result<usize>

Pull some bytes from this source into the specified buffer, returning how many bytes were read.

fn read_vectored(&mut self, bufs: &mut [IoSliceMut<'_>]) -> Result<usize, Error>

Like read, except that it reads into a slice of buffers.

fn is_read_vectored(&self) -> bool

🔬This is a nightly-only experimental API. (can_vector)

Determines if this Reader has an efficient read_vectored implementation.

fn read_to_end(&mut self, buf: &mut Vec<u8>) -> Result<usize, Error>

Reads all bytes until EOF in this source, placing them into buf.

fn read_to_string(&mut self, buf: &mut String) -> Result<usize, Error>

Reads all bytes until EOF in this source, appending them to buf.

fn read_exact(&mut self, buf: &mut [u8]) -> Result<(), Error>

Reads the exact number of bytes required to fill buf.

fn read_buf(&mut self, buf: BorrowedCursor<'_>) -> Result<(), Error>

🔬This is a nightly-only experimental API. (read_buf)

Pull some bytes from this source into the specified buffer.

fn read_buf_exact(&mut self, cursor: BorrowedCursor<'_>) -> Result<(), Error>

🔬This is a nightly-only experimental API. (read_buf)

Reads the exact number of bytes required to fill cursor.

fn by_ref(&mut self) -> &mut Self

where Self: Sized,

Creates a “by reference” adapter for this instance of Read.

fn bytes(self) -> Bytes<Self>

where Self: Sized,

Transforms this Read instance to an Iterator over its bytes.

fn chain<R>(self, next: R) -> Chain<Self, R>

where R: Read, Self: Sized,

Creates an adapter which will chain this stream with another.

fn take(self, limit: u64) -> Take<Self>

where Self: Sized,

Creates an adapter which will read at most limit bytes from it.

fn read_array<const N: usize>(&mut self) -> Result<[u8; N], Error>

where Self: Sized,

🔬This is a nightly-only experimental API. (read_array)

Read and return a fixed array of bytes from this source.

impl<R: Seek, E> Seek for BinaryReader<R, E>

fn seek(&mut self, pos: SeekFrom) -> Result<u64>

Seek to an offset, in bytes, in a stream.

fn rewind(&mut self) -> Result<(), Error>

Rewind to the beginning of a stream.

fn stream_len(&mut self) -> Result<u64, Error>

🔬This is a nightly-only experimental API. (seek_stream_len)

Returns the length of this stream (in bytes).

fn stream_position(&mut self) -> Result<u64, Error>

Returns the current seek position from the start of the stream.

fn seek_relative(&mut self, offset: i64) -> Result<(), Error>

Seeks relative to the current position.