Struct SymbolDict 

pub struct SymbolDict { /* private fields */ }

Connection-scoped symbol dictionary.

Implementations

impl SymbolDict

pub fn new() -> Self

pub fn len(&self) -> usize

Number of entries currently stored. Also the next conn-id to assign.

pub fn is_empty(&self) -> bool

pub fn heap_bytes(&self) -> usize

UTF-8 bytes currently held in the arena.

pub fn get(&self, id: u32) -> Option<&str>

Resolve a connection-scoped symbol id to its UTF-8 string.

pub fn arena(&self) -> &[u8]

Raw UTF-8 heap holding every entry’s bytes back-to-back.

pub fn entries(&self) -> &[SymbolEntry]

Entry table: index i addresses the conn-id-i symbol’s bytes within arena.

pub fn reset(&mut self)

Clear all state. Triggered by a CACHE_RESET with the dict bit. Shrinks the backing allocations so a previously-saturated dict doesn’t keep its full heap reserved after the reset.

pub fn apply_delta<'a, I>(&mut self, delta_start: u64, entries: I) -> Result<()>

where I: IntoIterator<Item = &'a [u8]>,

Apply a delta whose first new id is delta_start and whose entries are produced in order. Validates UTF-8 and the sequencing invariant.

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

Decode + apply a delta directly from the wire bytes. Returns the number of bytes consumed.

All-or-nothing: if any entry in the delta is malformed, the dict is rolled back to its pre-call state. Without this, a partial failure would leave self.entries.len() between the old and new expected values, and every subsequent delta would mismatch the delta_start check above and break the connection until reset.

Trait Implementations

impl Clone for SymbolDict

fn clone(&self) -> SymbolDict

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SymbolDict

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

Formats the value using the given formatter.

impl Default for SymbolDict

fn default() -> SymbolDict

Returns the “default value” for a type.