Struct StoreKeyPrefix 

pub struct StoreKeyPrefix { /* private fields */ }

A client-side namespace layered over raw Store keys.

The prefix consumes a small number of high bits in the physical Store key and stores the caller’s logical key in the remaining payload bits. QMDB, SQL, and other higher-level instances continue to build their own logical keys as before; a prefixed StoreClient maps those keys on the wire and maps returned keys back before callers see them.

Implementations

impl StoreKeyPrefix

pub fn new(reserved_bits: u8, prefix: u16) -> Result<Self, StoreKeyPrefixError>

pub fn reserved_bits(self) -> u8

pub fn prefix(self) -> u16

pub fn max_logical_key_len(self) -> usize

Maximum logical key bytes available under this prefix.

pub fn encode_key(self, key: &Key) -> Result<Key, StoreKeyPrefixError>

Encode a logical key into the physical Store keyspace.

pub fn decode_key(self, key: &Key) -> Result<Key, StoreKeyPrefixError>

Decode a physical Store key back into the logical keyspace.

pub fn encode_range( self, start: &Key, end: &Key, ) -> Result<(Key, Key), StoreKeyPrefixError>

Encode an inclusive logical range into the physical Store keyspace.

Empty end means unbounded in the logical keyspace and is narrowed to this prefix’s physical upper bound. Long logical upper bounds are clamped to the maximum logical key length representable under this prefix; this preserves scans over existing KeyCodec::prefix_bounds ranges, whose upper bound is intentionally MAX_KEY_LEN bytes.

Trait Implementations

impl Clone for StoreKeyPrefix

fn clone(&self) -> StoreKeyPrefix

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StoreKeyPrefix

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

Formats the value using the given formatter.

impl Hash for StoreKeyPrefix

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for StoreKeyPrefix

fn eq(&self, other: &StoreKeyPrefix) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for StoreKeyPrefix

impl Eq for StoreKeyPrefix

impl StructuralPartialEq for StoreKeyPrefix