Struct Packer 

pub struct Packer { /* private fields */ }

Writes a frame.

Implementations

impl Packer

pub fn new() -> Self

An empty packer.

pub fn put_u(&mut self, n: u64)

An unsigned number (a count, an index).

pub fn put_i(&mut self, n: i64)

A signed number, zigzagged.

pub fn put_bool(&mut self, b: bool)

A bool, a byte.

pub fn put_f64(&mut self, f: f64)

An f64, raw.

pub fn put_f32(&mut self, f: f32)

An f32, raw.

pub fn put_f64s(&mut self, items: &[f64])

Floats, raw: a count, whether they’re kept as f32 (when every one is one exactly — half the bytes), then each one’s bytes.

pub fn put_uints( &mut self, len: usize, items: impl Iterator<Item = u64> + Clone, )

Unsigned numbers bit-packed: a count, how many bits each takes (the biggest one’s, one at least), then the bits (lanes).

pub fn put_f32s(&mut self, items: &[f32])

f32s, raw: a count, then each one’s bytes.

pub fn put_str(&mut self, s: &str)

A string: its index in the table, which gets it the first time.

pub fn put_bytes(&mut self, b: &[u8])

Bytes: their count, then them.

pub fn put_tagged<T: Schema>(&mut self, v: &T)

v in its binary form, as bytes: what a frame holds of a type that doesn’t pack itself.

pub fn begin(&mut self) -> usize

A record starts: where its length goes (Packer::end fills it in).

pub fn begin_list(&mut self, len: usize) -> usize

A list of len items packed one by one: its count, then its length in bytes like a record’s (Packer::end writes it), so a reader can step over it.

pub fn end(&mut self, at: usize)

The record (or list) begun at at ends: its length written.

pub fn finish(self) -> Vec<u8>

The frame: its body, its strings, their length backwards.

pub fn with_frame<T: Schema, R>( &mut self, v: &T, f: impl FnOnce(&[u8]) -> R, ) -> R

f on v as a frame, packed in this packer’s buffers: a frame built without allocating once they’ve grown to the caller’s messages.

Trait Implementations

impl Debug for Packer

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

Formats the value using the given formatter.

impl Default for Packer

fn default() -> Self

Returns the “default value” for a type.