Struct MessageBuilder 

pub struct MessageBuilder { /* private fields */ }

Submessage-Aggregator.

Wird bei open mit einer vor-allokierten Byte-Liste beginnend beim RTPS-Header initialisiert. Submessages werden per try_add_submessage angehaengt; bei Full muss Caller finish() + neuen Builder.

Implementations

impl MessageBuilder

pub fn open(header: RtpsHeader, targets: Rc<Vec<Locator>>, mtu: usize) -> Self

Oeffnet einen neuen Builder mit gegebenem RTPS-Header, Zielen und MTU-Budget.

Panics: wenn mtu kleiner als der RTPS-Header (20 Byte).

pub fn submsg_count(&self) -> usize

Anzahl bisher eingefuegter Submessages.

pub fn is_empty(&self) -> bool

True wenn der Builder nur den RTPS-Header enthaelt.

pub fn len(&self) -> usize

Aktuelle Gesamt-Byte-Zahl (Header + bereits angehaengte Submessages).

pub fn remaining(&self) -> usize

Verbleibendes Budget in Bytes.

pub fn try_add_submessage( &mut self, id: SubmessageId, flags: u8, body: &[u8], ) -> Result<(), AddError>

Versucht, eine Submessage anzuhaengen. Liefert AddError::WouldExceedMtu, wenn sie nicht mehr reinpasst — dann ist finish() + neuer Builder faellig.

flags enthaelt nur die submessage-spezifischen Flags (F, L, Q, H, K, N etc.). Das E-Bit (Little-Endian) setzt der Builder selbst, konsistent fuer das ganze Datagramm.

Errors

• AddError::WouldExceedMtu bei Size-Overflow.
• AddError::BodyTooLarge wenn body.len() > u16::MAX.

pub fn finish(self) -> Option<OutboundDatagram>

Wandelt in ein fertiges OutboundDatagram um.

Liefert None bei leerem Builder (nur RTPS-Header ohne Submessages) — das erlaubt Aufrufern, unbenutzte Builder einfach zu verwerfen, ohne vorher is_empty() pruefen zu muessen.

Trait Implementations

impl Debug for MessageBuilder

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

Formats the value using the given formatter.