Struct SnapshotEncoder 

pub struct SnapshotEncoder<'output, E> { /* private fields */ }

Fixed-buffer snapshot encoder used by provider request components.

Instances are created only by encode_snapshot and encode_snapshot_bounded. The first pass measures with checked arithmetic; the second pass receives an exactly sized destination.

Implementations

impl<'output, E: Copy> SnapshotEncoder<'output, E>

pub const fn len(&self) -> usize

Returns the number of bytes measured or written.

pub const fn is_empty(&self) -> bool

Reports whether no bytes have been measured or written.

pub fn byte(&mut self, value: u8) -> Result<(), E>

Appends one byte.

pub fn bytes(&mut self, value: &[u8]) -> Result<(), E>

Appends bytes without escaping.

pub fn string(&mut self, value: &str) -> Result<(), E>

Appends UTF-8 without escaping.

pub fn u64(&mut self, value: u64) -> Result<(), E>

Appends a base-10 unsigned integer.

pub fn percent_encoded(&mut self, value: &str) -> Result<(), E>

Appends one RFC 3986 percent-encoded component.

pub fn form_component(&mut self, value: &str) -> Result<(), E>

Appends one application/x-www-form-urlencoded component.

ASCII spaces become +; ASCII alphanumerics and *, -, ., and _ remain literal; every other UTF-8 byte uses uppercase percent encoding. Separators such as & and = are always encoded when they occur inside a component.

pub fn json_string_escaped(&mut self, value: &str) -> Result<(), E>

Appends JSON string contents without surrounding quotes.

pub fn json_string(&mut self, value: &str) -> Result<(), E>

Appends a complete JSON string.

pub fn query_pair( &mut self, first: &mut bool, key: &str, value: &str, ) -> Result<(), E>

Appends a percent-encoded query pair.

pub fn query_u64( &mut self, first: &mut bool, key: &str, value: u64, ) -> Result<(), E>

Appends a percent-encoded query key and base-10 integer.

pub fn query_separator(&mut self, first: &mut bool) -> Result<(), E>

Appends & unless this is the first query pair.