Struct rhai::GlobalRuntimeState

pub struct GlobalRuntimeState<'a> {
    pub source: Identifier,
    pub num_operations: u64,
    pub num_modules_loaded: usize,
    pub scope_level: usize,
    pub always_search_scope: bool,
    pub embedded_module_resolver: Option<Shared<StaticModuleResolver>>,
    pub constants: Option<Shared<Locked<BTreeMap<ImmutableString, Dynamic>>>>,
    pub tag: Dynamic,
    pub debugger: Debugger,
    /* private fields */
}

(internals) Global runtime states. Exported under the internals feature only.

Fields

source: Identifier

Source of the current context.

No source if the string is empty.

num_operations: u64

Number of operations performed.

num_modules_loaded: usize

Number of modules loaded.

scope_level: usize

Level of the current scope.

The global (root) level is zero, a new block (or function call) is one level higher, and so on.

always_search_scope: bool

Force a Scope search by name.

Normally, access to variables are parsed with a relative offset into the Scope to avoid a lookup.

In some situation, e.g. after running an eval statement, or after a custom syntax statement, subsequent offsets may become mis-aligned.

When that happens, this flag is turned on.

embedded_module_resolver: Option<Shared<StaticModuleResolver>>

Embedded module resolver.

constants: Option<Shared<Locked<BTreeMap<ImmutableString, Dynamic>>>>

Cache of globally-defined constants.

Interior mutability is needed because it is shared in order to aid in cloning.

tag: Dynamic

Custom state that can be used by the external host.

debugger: Debugger

Debugging interface.

Implementations

impl GlobalRuntimeState<'_>

pub fn new(engine: &Engine) -> Self

Create a new GlobalRuntimeState based on an Engine.

pub fn num_imports(&self) -> usize

Get the length of the stack of globally-imported modules.

Not available under no_module.

pub fn get_shared_import(&self, index: usize) -> Option<Shared<Module>>

Get the globally-imported module at a particular index.

Not available under no_module.

pub fn find_import(&self, name: &str) -> Option<usize>

Get the index of a globally-imported module by name.

Not available under no_module.

pub fn push_import(
    &mut self,
    name: impl Into<ImmutableString>,
    module: impl Into<Shared<Module>>
)

Push an imported module onto the stack.

Not available under no_module.

pub fn truncate_imports(&mut self, size: usize)

Truncate the stack of globally-imported modules to a particular length.

Not available under no_module.

pub fn iter_imports(&self) -> impl Iterator<Item = (&str, &Module)>

Get an iterator to the stack of globally-imported modules in reverse order.

Not available under no_module.

pub fn scan_imports_raw(
    &self
) -> impl Iterator<Item = (&ImmutableString, &Shared<Module>)>

Get an iterator to the stack of globally-imported modules in forward order.

Not available under no_module.

pub fn contains_qualified_fn(&self, hash: u64) -> bool

Does the specified function hash key exist in the stack of globally-imported modules?

Not available under no_module.

pub fn get_qualified_fn(
    &self,
    hash: u64
) -> Option<(&CallableFunction, Option<&str>)>

Get the specified function via its hash key from the stack of globally-imported modules.

Not available under no_module.

pub fn contains_iter(&self, id: TypeId) -> bool

Does the specified TypeId iterator exist in the stack of globally-imported modules?

Not available under no_module.

pub fn get_iter(
    &self,
    id: TypeId
) -> Option<&dyn Fn(Dynamic) -> Box<dyn Iterator<Item = Result<Dynamic, Box<EvalAltResult>>>>>

Get the specified TypeId iterator from the stack of globally-imported modules.

Not available under no_module.

pub fn source(&self) -> Option<&str>

Get the current source.

Trait Implementations

impl<'a> Clone for GlobalRuntimeState<'a>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for GlobalRuntimeState<'_>

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

Formats the value using the given formatter.

impl<K: Into<ImmutableString>, M: Into<Shared<Module>>> Extend<(K, M)> for GlobalRuntimeState<'_>

fn extend<T: IntoIterator<Item = (K, M)>>(&mut self, iter: T)

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: A)

🔬This is a nightly-only experimental API. (extend_one)

Extends a collection with exactly one element.

fn extend_reserve(&mut self, additional: usize)

🔬This is a nightly-only experimental API. (extend_one)

Reserves capacity in a collection for the given number of additional elements.

impl<'a> IntoIterator for &'a GlobalRuntimeState<'_>

type Item = (&'a ImmutableString, &'a Rc<Module>)

The type of the elements being iterated over.

type IntoIter = Zip<Rev<Iter<'a, ImmutableString>>, Rev<Iter<'a, Rc<Module>>>>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl IntoIterator for GlobalRuntimeState<'_>

type Item = (ImmutableString, Rc<Module>)

The type of the elements being iterated over.

type IntoIter = Zip<Rev<IntoIter<[ImmutableString; 3]>>, Rev<IntoIter<[Rc<Module>; 3]>>>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.