Struct PublishLoan 

pub struct PublishLoan<'a, const TX_BUF: usize> { /* private fields */ }

Writable loan into a EmbeddedRawPublisher’s slot.

User fills as_mut() then calls commit to publish, or discard to release the slot without publishing. Dropping without either silently discards (slot freed); a #[must_use] warning catches accidental drops at compile time.

Two backings, selected at compile time by the rmw-lending feature:

• Arena (default): per-publisher inline [u8; TX_BUF] slot. On commit, publish_raw memcpys into the backend’s outbound buffer.
• Backend lending (rmw-lending): slot owned by the backend (zenoh-pico’s static buffer aliased via z_bytes_from_static_buf, XRCE’s ucdrBuffer reservation). True zero-copy publish.

Implementations

impl<'a, const TX_BUF: usize> PublishLoan<'a, TX_BUF>

pub fn as_mut(&mut self) -> &mut [u8]

Mutable view into the loaned bytes. Caller writes message data here.

pub fn commit(self) -> Result<(), LoanError>

Commit the loan: hand the bytes to the backend’s publish_raw, then release the arena slot. Returns the backend’s publish error if any (slot is released regardless).

pub fn discard(self)

Discard the loan without publishing. Equivalent to dropping, but explicit (no #[must_use] warning).

Trait Implementations

impl<'a, const TX_BUF: usize> Drop for PublishLoan<'a, TX_BUF>

Available on non-crate feature rmw-lending only.

fn drop(&mut self)

Executes the destructor for this type.