Struct Producer 

pub struct Producer<'a> { /* private fields */ }

Writes the payload of the single in-flight frame in one or more chunks.

Borrows the parent group::Producer exclusively, so no other frame can be opened while this one is live. The total bytes written must exactly match Info::size; call Self::finish to commit the frame (or Self::abort to fail it). Dropping without either aborts the group, since an unfinished frame leaves the group’s stream broken.

A single whole-frame write keeps the caller’s allocation (zero-copy); chunked writes copy into one buffer sized to the declared frame.

Implementations

impl<'a> Producer<'a>

pub fn group(&self) -> Info

The parent group this frame belongs to.

pub fn remaining(&self) -> usize

Bytes still needed to complete the frame.

pub fn write<B: IntoBytes>(&mut self, chunk: B) -> Result<()>

Write a chunk of data to the frame.

Returns Error::WrongSize if the chunk would exceed the remaining bytes.

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

Commit the frame, verifying that all bytes were written.

Returns Error::WrongSize if the bytes written don’t match Info::size.

pub fn abort(self, err: Error) -> Result<()>

Abort the frame (and its group) with the given error.

Trait Implementations

impl Deref for Producer<'_>

type Target = Info

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl Drop for Producer<'_>

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.