Struct DynamicTable 

pub struct DynamicTable { /* private fields */ }

Available on crate features http-backend and http and std only.

The QPACK dynamic table.

Implementations

impl DynamicTable

pub fn new(max_capacity: u64) -> DynamicTable

Create a table whose capacity may grow up to max_capacity bytes. Its current capacity starts at zero until a Set Dynamic Table Capacity instruction raises it.

pub fn max_capacity(&self) -> u64

The configured maximum capacity (SETTINGS_QPACK_MAX_TABLE_CAPACITY).

pub fn capacity(&self) -> u64

The current maximum capacity.

pub fn size(&self) -> u64

The current size in bytes.

pub fn max_entries(&self) -> u64

MaxEntries = floor(MaxTableCapacity / 32) (RFC 9204 §3.2.2), from the configured maximum capacity. Used for Required Insert Count wraparound.

pub fn insert_count(&self) -> u64

The total number of entries ever inserted; equivalently, the next absolute index.

pub fn dropped(&self) -> u64

The absolute index of the oldest entry still present (equal to insert_count when empty).

pub fn get(&self, abs: u64) -> Option<(Bytes, Bytes)>

The name and value of the entry at absolute index abs, if present.

pub fn set_capacity(&mut self, capacity: u64) -> bool

Set the current maximum capacity (RFC 9204 §3.2.3), evicting oldest entries until the size fits. Returns false if capacity exceeds the configured maximum.

This performs unconditional eviction, so a caller that tracks references must not reduce capacity below its referenced entries.

pub fn can_insert( &self, need: u64, acknowledged: Option<u64>, ) -> Result<(), InsertError>

Check insertion before allocating or mutating the table. An encoder supplies its Known Received Count; a decoder supplies None because encoder-stream ordering permits eviction.

pub fn insert( &mut self, name: Bytes, value: Bytes, acknowledged: Option<u64>, ) -> Result<u64, InsertError>

Insert an entry, evicting as needed (RFC 9204 §3.2.2). An encoder must supply its Known Received Count: even an unreferenced entry cannot be evicted until acknowledged. The decoder supplies None and applies the peer’s ordered instructions unconditionally.

pub fn add_ref(&mut self, abs: u64)

Add a reference to the entry at absolute index abs (encoder only).

pub fn release_ref(&mut self, abs: u64)

Release a reference from the entry at absolute index abs (encoder only).

pub fn is_referenced(&self, abs: u64) -> bool

Whether the entry at absolute index abs currently has outstanding references.

pub fn find(&self, name: &[u8], value: &[u8]) -> Option<u64>

The absolute index of the newest entry whose name and value both match, if any.

pub fn find_name(&self, name: &[u8]) -> Option<u64>

The absolute index of the newest entry whose name matches, if any.

Trait Implementations

impl Clone for DynamicTable

fn clone(&self) -> DynamicTable

Returns a duplicate of the value.

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

Performs copy-assignment from source.