Struct StringIndex 

pub struct StringIndex { /* private fields */ }

Secondary index mapping variable-length string keys to fixed 32-byte DonaDbX keys.

Implementations

impl StringIndex

pub fn new() -> Self

Create a new empty string index with 256 shards.

pub fn with_persistence(path: &Path) -> Result<Self>

Create a string index with persistence to a manifest file.

pub fn save_to_disk(&self) -> Result<()>

Save the string index to disk.

pub fn insert(&self, string_key: &[u8], fixed_key: [u8; 32])

Insert or update a string key → 32-byte key mapping.

pub fn remove(&self, string_key: &[u8])

Remove a string key from the index.

pub fn get(&self, string_key: &[u8]) -> Option<[u8; 32]>

Get the fixed 32-byte key for a string key.

pub fn scan_prefix(&self, prefix: &[u8]) -> Vec<(Vec<u8>, [u8; 32])>

Scan for all keys matching a prefix, return (string_key, fixed_key) pairs.

This collects from all shards in parallel and sorts the results lexicographically. Fast for small result sets (typical blockchain queries return 10-1000 entries).

pub fn scan_from_reverse( &self, start: &[u8], limit: usize, ) -> Vec<(Vec<u8>, [u8; 32])>

Scan in reverse from a starting key (exclusive).

Returns all entries lexicographically less than start, in descending order.

pub fn clear(&self)

Clear all entries from the index.

pub fn len(&self) -> usize

Return the total number of entries across all shards.

pub fn is_empty(&self) -> bool

Check if the index is empty.

Trait Implementations

impl Default for StringIndex

fn default() -> Self

Returns the “default value” for a type.