Struct Agent 

pub struct Agent { /* private fields */ }

Agent encapsulates query, key, and state for trie operations.

An agent is used for:

• Lookup operations (query → key with ID)
• Reverse lookup (query with ID → key with string)
• Common prefix search
• Predictive search

Implementations

impl Agent

pub fn new() -> Self

Creates a new empty agent.

pub fn query(&self) -> &Query

Returns a reference to the query.

pub fn query_mut(&mut self) -> &mut Query

Returns a mutable reference to the query.

pub fn key(&self) -> &Key

Returns a reference to the key.

pub fn key_mut(&mut self) -> &mut Key

Returns a mutable reference to the key.

pub fn set_query_str(&mut self, s: &str)

Sets the query from a string slice.

pub fn set_query_bytes(&mut self, bytes: &[u8])

Sets the query from a byte slice.

pub fn set_query_id(&mut self, key_id: usize)

Sets the query from a key ID for reverse lookup.

pub fn state(&self) -> Option<&State>

Returns a reference to the state if it exists.

pub fn state_mut(&mut self) -> Option<&mut State>

Returns a mutable reference to the state if it exists.

pub fn set_key_str(&mut self, s: &str)

Sets the key from a string slice.

pub fn set_key_bytes(&mut self, bytes: &[u8])

Sets the key from a byte slice.

pub fn set_key_id(&mut self, id: usize)

Sets the key ID.

pub fn set_key_from_state_buf(&mut self)

Sets the key to point to the state’s key buffer.

This is used after operations like reverse_lookup that build the key in the state’s buffer.

pub fn set_key_from_query(&mut self)

Sets the key to point to the query buffer.

This is used after a successful lookup to set the result key to the query string that was searched for.

pub fn set_key_from_query_prefix(&mut self, length: usize)

Sets the key to point to a prefix of the query buffer.

This is used during prefix searches to set the result key to a prefix of the query string.

Arguments

• length - Length of the prefix

pub fn has_state(&self) -> bool

Returns true if the agent has state.

pub fn init_state(&mut self) -> Result<()>

Initializes state for complex searches.

Errors

Returns an error if state is already initialized.

pub fn clear(&mut self)

Clears the agent to empty state.

pub fn swap(&mut self, other: &mut Agent)

Swaps with another agent.

Trait Implementations

impl Clone for Agent

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for Agent

fn default() -> Self

Returns the “default value” for a type.