Struct ResponseAttempt 

pub struct ResponseAttempt<'writer, 'buffer> { /* private fields */ }

Cleanup-owning transaction around one response write attempt.

Transport implementations should acquire this guard before touching the response writer. Dropping an uncommitted guard, including during panic unwind or future cancellation, clears the complete body and header storage.

Implementations

impl<'buffer> ResponseAttempt<'_, 'buffer>

pub const fn body_capacity(&self) -> usize

Returns the admitted response-body capacity.

pub fn body_mut(&mut self) -> Result<&mut [u8], ResponseWriterError>

Returns exclusive access to the admitted response-body prefix.

pub fn headers_mut( &mut self, ) -> Result<&mut ResponseHeaders<'buffer>, ResponseWriterError>

Returns mutable caller-owned response-header storage.

pub const fn headers(&self) -> &ResponseHeaders<'buffer>

Returns response headers captured by this attempt.

pub fn commit( &mut self, status: StatusCode, initialized_len: usize, metadata: ResponseMetadata, ) -> Result<(), ResponseWriterError>

Commits this attempt exactly once.

Trait Implementations

impl Drop for ResponseAttempt<'_, '_>

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.