Struct WriterEmitter 

pub struct WriterEmitter<W: Write> { /* private fields */ }

Writes EDIFACT events directly to any Write implementation.

Each event is written to the underlying writer immediately — no intermediate buffering of element strings occurs, so no heap allocation is required per event. This makes WriterEmitter suitable for high-throughput serialization of large EDIFACT messages.

Protocol

Events must arrive in the order produced by crate::EdifactSerialize: StartSegment → zero or more (Element → zero or more ComponentElement) → EndSegment.

Any violation of this protocol returns EdifactError::InvalidEventSequence immediately. Violations are detected in both debug and release builds.

Implementations

impl<W: Write> WriterEmitter<W>

pub fn new(inner: W) -> Self

Create a new WriterEmitter with default EDIFACT delimiters.

pub fn with_una( inner: W, ssa: ServiceStringAdvice, ) -> Result<Self, EdifactError>

Create a new WriterEmitter with custom delimiters, writing a UNA header first.

Errors

Returns EdifactError::InvalidUna when ssa.is_valid() is false.

pub fn finish(self) -> Result<W, EdifactError>

Flush and consume the emitter, returning the underlying writer.

pub fn segment_count(&self) -> u64

Number of complete segments written so far.

pub fn service_string_advice(&self) -> ServiceStringAdvice

Return the active ServiceStringAdvice.

Callers can use this to format values (e.g., floats) using the correct decimal-mark character configured in the UNA header.

Trait Implementations

impl<W: Write> EventEmitter for WriterEmitter<W>

fn decimal_mark(&self) -> u8

Return the decimal-mark byte used by the interchange (b'.' by default).

fn emit(&mut self, event: EdifactEvent<'_>) -> Result<(), EdifactError>

Consume one event.