Struct Q42LexMmap 

pub struct Q42LexMmap<'a> { /* private fields */ }

Zero-allocation view over a memory-mapped .q42.lex slice (sorted hash index).

Implementations

impl<'a> Q42LexMmap<'a>

pub fn from_bytes(data: &'a [u8]) -> Result<Self, LexError>

Parse a Q42LEX byte slice (typically from mmap).

pub fn entry_count(&self) -> usize

pub fn hash_at(&self, i: usize) -> Option<u64>

Hash at sorted ordinal i, independent of whether the lexicon is the legacy flat layout or the paged v2 layout. Cold loaders use this rather than reaching into an on-disk index with v1 assumptions.

pub fn lookup_hash(&self, hash: u64) -> Option<&'a str>

Binary search for hash in the sorted index; returns the UTF-8 lexeme slice.

pub fn string_at(&self, i: usize) -> Option<&'a str>

The lexeme string of the i-th index entry (0..entry_count), if it is a UTF-8 string entry (not an embedded-triple / Webizen entry). Enables iterating ALL lexicon strings without knowing their hashes — e.g. to assemble a calibration corpus from a WordNet q42’s gloss text.

pub fn lookup_embedded_triple(&self, hash: u64) -> Option<[u64; 3]>

Binary search for hash in the sorted index; returns the embedded triple [subject, predicate, object].

Used by SPARQL-Star Virtual ID resolution: a Virtual ID is the FNV-1a hash of an embedded triple, stored in the lexicon with tag LEX_TAG_EMBEDDED instead of LEX_TAG_STRING.

pub fn lookup_webizen_identity(&self, hash: u64) -> Option<&'a str>

Binary search for hash; returns the authoritative Webizen identity string.

Trait Implementations

impl<'a> Clone for Q42LexMmap<'a>

fn clone(&self) -> Q42LexMmap<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Q42LexMmap<'a>

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

Formats the value using the given formatter.

impl<'a> Copy for Q42LexMmap<'a>