Struct Context 

#[non_exhaustive]
pub struct Context {
    pub core: Core,
    pub string_cache: StringCache,
}

Stores the State, Rules and Atom mappings for a Throne script.

Create a new Context using a ContextBuilder.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

core: Core

string_cache: StringCache

Implementations

impl Context

pub fn update(&mut self) -> Result<(), Error>

Executes any Rule that matches the current State until the set of matching rules is exhausted.

pub fn update_with_side_input<F>(&mut self, side_input: F) -> Result<(), Error>

where F: SideInput,

Equivalent to Context::update(), but accepts a callback to respond to ^ predicates.

pub fn execute_rule(&mut self, rule: &Rule) -> bool

Executes a specific Rule.

Returns true if the Rule was successfully executed or false if some of its inputs could not be matched to the current State.

pub fn find_matching_rules<F>( &self, side_input: F, ) -> Result<Vec<Rule>, ExcessivePermutationError>

where F: SideInput,

Returns the set of Rules that may be executed in the next update.

pub fn str_to_atom(&mut self, text: &str) -> Atom

Alias for StringCache::str_to_atom.

pub fn str_to_existing_atom(&self, text: &str) -> Option<Atom>

Alias for StringCache::str_to_existing_atom.

pub fn atom_to_str(&self, atom: Atom) -> Option<&str>

Alias for StringCache::atom_to_str.

pub fn atom_to_integer(&self, atom: Atom) -> Option<i32>

Alias for StringCache::atom_to_integer.

pub fn push_state(&mut self, phrase_text: &str)

Converts the provided text to a Phrase and adds it to the context’s State.

pub fn extend_state_from_context(&mut self, other: &Context)

Copies the state from another Context to this one.

pub fn print(&self)

Prints a representation of the Context to the console.

Trait Implementations

impl Clone for Context

fn clone(&self) -> Context

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Display for Context

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

Formats the value using the given formatter.