Struct Environment 

pub struct Environment {
    pub condition_info: Option<ConditionInfoData>,
    /* private fields */
}

A variable environment (scope).

Fields

condition_info: Option<ConditionInfoData>

Most recent condition trap info (for CONDITION() BIF).

Implementations

impl Environment

pub fn new() -> Self

pub fn get(&self, name: &str) -> RexxValue

Get a simple variable’s value. In REXX, an unset variable returns its own name in uppercase.

REXX scoping: PROCEDURE creates an opaque wall. Only the current (topmost) scope is searched. EXPOSE copies specific variables into the new scope — that’s the only way through.

pub fn set(&mut self, name: &str, value: RexxValue)

Set a simple variable.

pub fn get_compound(&self, stem: &str, resolved_tail: &str) -> RexxValue

Get a compound variable: stem.tail The tail components are resolved (each variable in the tail is looked up) and concatenated with dots.

pub fn set_compound( &mut self, stem: &str, resolved_tail: &str, value: RexxValue, )

Set a compound variable.

pub fn set_stem_default(&mut self, stem: &str, value: RexxValue)

Set the default value for a stem (e.g., stem. = 0).

pub fn drop(&mut self, name: &str)

DROP a variable — restore it to its uninitialized state.

pub fn push_procedure(&mut self)

PROCEDURE — push a new empty scope.

pub fn push_procedure_expose(&mut self, names: &[String])

PROCEDURE EXPOSE — push a new scope that shares specified variables.

pub fn pop_procedure(&mut self)

Pop the current scope (on RETURN from a PROCEDURE). Writes back any exposed variables to the parent scope.

pub fn address(&self) -> &str

Return the current default ADDRESS environment name.

pub fn set_address(&mut self, env: &str)

Set a new default ADDRESS environment, saving the old as previous.

pub fn swap_address(&mut self)

Swap default ↔ previous ADDRESS environment.

pub fn set_source_path(&mut self, path: PathBuf)

Set the source file path (for external function resolution and PARSE SOURCE).

pub fn clear_source_path(&mut self)

Clear the source file path (restores REPL/no-file state).

pub fn source_path(&self) -> Option<&Path>

Get the source file path.

pub fn source_dir(&self) -> Option<&Path>

Get the directory containing the source file.

pub fn set_condition_info(&mut self, info: ConditionInfoData)

Set condition info (called when a trap fires).

pub fn is_set(&self, name: &str) -> bool

Check if a simple variable has been explicitly set (for SIGNAL ON NOVALUE).

pub fn is_compound_set(&self, stem: &str, resolved_tail: &str) -> bool

Check if a compound variable has been explicitly set (for SIGNAL ON NOVALUE). Returns true if the specific tail has a value OR the stem has a default.

Trait Implementations

impl Clone for Environment

fn clone(&self) -> Environment

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Environment

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

Formats the value using the given formatter.

impl Default for Environment

fn default() -> Self

Returns the “default value” for a type.