Struct MessageWriter 

pub struct MessageWriter<'w, W: Write> { /* private fields */ }

RAII guard for a single EDIFACT message within an interchange.

Obtained from Writer::begin_message. Writes UNH on creation and UNT (with the correct per-message segment count) when finish is called or the guard is dropped.

Always prefer calling finish explicitly so that write errors can be propagated. The Drop impl writes UNT as a best-effort fallback but silently discards I/O errors.

Example

let mut writer = Writer::new(Vec::new());
writer.begin_interchange("UNOA", "1", "SENDER", "RECEIVER", "200101", "0900", "1")?;
{
    let mut msg = writer.begin_message("1", "ORDERS", "D", "96A", "UN")?;
    msg.write_raw("BGM", &["220", "PO001", "9"])?;
    msg.finish()?;
}
writer.end_interchange(1, "1")?;

Implementations

impl<W: Write> MessageWriter<'_, W>

pub fn write_raw( &mut self, tag: &str, elements: &[&str], ) -> Result<(), EdifactError>

Write a segment within this message.

Delegates to Writer::write_raw.

pub fn write_elements( &mut self, tag: &str, elements: &[DataElement<'_>], ) -> Result<(), EdifactError>

Write a segment mixing simple and composite data elements within this message.

Delegates to Writer::write_elements — the general form, and the one to reach for when a segment is not uniformly simple or uniformly composite.

Errors

Returns EdifactError if the underlying writer fails.

pub fn write_composites( &mut self, tag: &str, elements: &[&[&str]], ) -> Result<(), EdifactError>

Write a segment from borrowed element/component slices within this message.

Delegates to Writer::write_composites.

Errors

Returns EdifactError if the underlying writer fails.

pub fn write_segment_parts<E>( &mut self, tag: &str, elements: &[E], ) -> Result<(), EdifactError>

where E: AsRef<[String]>,

Write a segment from pre-split, owned element/component data within this message.

Delegates to Writer::write_segment_parts.

Errors

Returns EdifactError if the underlying writer fails.

pub fn write_segment(&mut self, seg: &Segment<'_>) -> Result<(), EdifactError>

Write a fully-typed segment within this message.

Delegates to Writer::write_segment.

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

Compute the per-message segment count and write UNT, consuming the guard.

The count written into UNT DE 0074 includes UNH, all content segments, and UNT itself — matching the EDIFACT standard.

Errors

Returns EdifactError if writing the UNT segment fails.

Trait Implementations

impl<W: Write> Drop for MessageWriter<'_, W>

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

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

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.