Struct BufferReader 

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

Read buffer with alignment tracking.

Implementations

impl<'a> BufferReader<'a>

pub fn new(bytes: &'a [u8], endianness: Endianness) -> Self

Constructs a reader over the given slice (XCDR1 cap 8).

pub fn with_align_origin(self, origin: usize) -> Self

Builder: sets the virtual Self::align origin (default 0). For GIOP 1.2 = 12 (header size), MUST match the encode side.

pub fn with_max_alignment(self, max_alignment: usize) -> Self

Builder: sets the alignment cap (XCDR1=8, XCDR2=4). Inherited by nested member readers.

pub fn xcdr2(self) -> Self

Builder: switches to XCDR2 alignment (cap 4, §7.4.1.1.1).

pub fn max_alignment(&self) -> usize

The current alignment cap (8 = XCDR1, 4 = XCDR2).

pub fn endianness(&self) -> Endianness

Current endianness.

pub fn position(&self) -> usize

Current position in the stream.

pub fn remaining(&self) -> usize

Remaining bytes until the end.

pub fn align(&mut self, alignment: usize) -> Result<(), DecodeError>

Skips padding until the next alignment boundary.

Errors

UnexpectedEof when not enough bytes remain for the padding.

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

Reads exactly n bytes as a slice (without alignment).

Errors

UnexpectedEof.

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

Reads a single byte.

Errors

UnexpectedEof.

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

Aligns + reads u16.

Errors

UnexpectedEof.

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

Aligns + reads u32.

Errors

UnexpectedEof.

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

Aligns + reads u64.

Errors

UnexpectedEof.

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

Reads a CDR string (§9.3.2.7): 4-byte length (incl. null terminator) + UTF-8 bytes + 1 null byte. Returns the string without the terminator.

Errors

UnexpectedEof for too-short data; InvalidData for non-UTF-8 bytes, a missing null terminator, or length == 0.

Trait Implementations

impl<'a> Clone for BufferReader<'a>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for BufferReader<'a>

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

Formats the value using the given formatter.