Struct BufferWriter 

pub struct BufferWriter { /* private fields */ }

Write buffer with alignment tracking and configurable endianness.

Phase 0 uses Vec<u8> as backing — a growing alloc feature.

Implementations

impl BufferWriter

pub fn new(endianness: Endianness) -> Self

Creates an empty writer with the given endianness (XCDR1 alignment, cap 8 — default + backward-compat).

pub fn with_capacity(endianness: Endianness, cap: usize) -> Self

Creates a writer with pre-allocated capacity (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), see the align_origin field doc.

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

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

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

Returns the current endianness.

pub fn position(&self) -> usize

Current position (== number of bytes written so far).

pub fn into_bytes(self) -> Vec<u8>

Consumes the writer and returns the written buffer.

pub fn as_bytes(&self) -> &[u8]

Read-only view of the buffer written so far.

pub fn align(&mut self, alignment: usize)

Inserts null padding until the current position is a multiple of alignment. Alignment must be a power of two (1, 2, 4, 8); other values are undefined in XCDR.

pub fn write_bytes(&mut self, data: &[u8]) -> Result<(), EncodeError>

Writes raw bytes without alignment.

Errors

Never returns an error with Vec-based backing — the signature is symmetric to the slice-based writer (Phase 1).

pub fn write_u8(&mut self, value: u8) -> Result<(), EncodeError>

Writes a single byte (1-byte alignment).

Errors

As write_bytes.

pub fn write_u16(&mut self, value: u16) -> Result<(), EncodeError>

Aligns + writes u16.

Errors

As write_bytes.

pub fn write_u32(&mut self, value: u32) -> Result<(), EncodeError>

Aligns + writes u32.

Errors

As write_bytes.

pub fn write_u64(&mut self, value: u64) -> Result<(), EncodeError>

Aligns + writes u64.

Errors

As write_bytes.

pub fn write_string(&mut self, s: &str) -> Result<(), EncodeError>

Writes a CDR string (§9.3.2.7): 4-byte length (incl. null terminator) + UTF-8 bytes + 1 null byte. No trailing padding — the next field aligns itself.

Errors

As write_bytes.

Trait Implementations

impl Clone for BufferWriter

fn clone(&self) -> BufferWriter

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BufferWriter

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

Formats the value using the given formatter.