Struct Executor 

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

Query executor that searches through an open index and verifies candidate files against the original regex.

Optional caching layers reduce redundant work across queries:

• PostingCache avoids re-decoding compressed posting lists
• NegCache skips re-verification of known non-matching files
• RegexPool caches compiled regex objects across queries

Implementations

impl<'a> Executor<'a>

pub fn new(index: &'a Reader) -> Self

Create an executor backed by the given index reader with default caches.

pub fn new_with_caches( index: &'a Reader, posting_cache: Arc<PostingCache>, neg_cache: Arc<NegCache>, regex_pool: Arc<RegexPool>, ) -> Self

Create an executor that shares caches with another executor.

Use this in daemon mode to reuse posting list, negative, and regex caches across queries without re-decoding or re-verifying.

pub fn posting_cache(&self) -> &PostingCache

Returns a reference to the posting list cache.

pub fn neg_cache(&self) -> &NegCache

Returns a reference to the negative result cache.

pub fn regex_pool(&self) -> &RegexPool

Returns a reference to the regex compilation pool.

pub fn execute( &mut self, plan: &QueryPlan, options: &QueryOptions, ) -> Result<(Vec<Match>, QueryStats)>

Execute a query plan against the index.

Errors

Returns an error if I/O fails when reading index sections, if posted data is corrupted, or if file content cannot be read during verification.

pub fn verify_stream_for_test<R: Read>( &self, reader: R, path: &Path, regex: &Regex, options: &QueryOptions, ) -> Result<Vec<Match>>

Exposed for integration testing of the streaming logic.

Errors

Returns an error if the file content cannot be read or if regex matching operations fail.