Struct DomainStack 

pub struct DomainStack { /* private fields */ }

Ordered stack of domain dictionaries searched in priority order.

The internal vector is kept sorted by priority ascending (lowest value = highest priority) at all times. add_domain and remove_domain preserve this invariant.

Implementations

impl DomainStack

pub fn new() -> DomainStack

Create an empty domain stack.

pub fn add_domain( &mut self, domain: DomainId, priority: u8, dict: Arc<UserDictionary>, source: Option<PathBuf>, )

Add or replace a domain.

If a domain with the same DomainId already exists it is replaced with the new dictionary and priority. The stack remains sorted after the operation.

pub fn remove_domain(&mut self, domain: &DomainId) -> Option<DomainDictionary>

Remove a domain by id.

Returns the removed DomainDictionary, or None if no domain with the given id existed.

pub fn get_domain(&self, domain: &DomainId) -> Option<&DomainDictionary>

Look up a domain by id.

pub fn list_domains(&self) -> Vec<(DomainId, u8, usize)>

Return (DomainId, priority, entry_count) for every registered domain, in priority order (highest priority first).

pub fn len(&self) -> usize

Number of registered domains.

pub fn is_empty(&self) -> bool

True when no domains are registered.

pub fn common_prefix_search<'a>(&'a self, text: &str) -> Vec<&'a UserEntry>

Common-prefix search across all domains.

Returns all matching UserEntry references in priority order (higher priority = lower numeric value appears first). Within the same domain, entry order follows the domain’s own iteration order.

The returned references are valid for the lifetime of &self.

pub fn lookup<'a>(&'a self, surface: &str) -> Vec<&'a UserEntry>

Exact surface lookup across all domains.

Returns all UserEntry references whose surface equals surface, in priority order.

The returned references are valid for the lifetime of &self.

Trait Implementations

impl Debug for DomainStack

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

Formats the value using the given formatter.

impl Default for DomainStack

fn default() -> DomainStack

Returns the “default value” for a type.