Struct Environment 

pub struct Environment {
    inner: Rc<RefCell<EnvInner>>,
}

Fields

inner: Rc<RefCell<EnvInner>>

Implementations

impl Environment

pub fn ptr_eq(&self, other: &Environment) -> bool

Check if two environments are the same object (pointer equality).

impl Environment

pub fn new_global() -> Self

pub fn new_child(parent: &Environment) -> Self

pub fn get(&self, name: &str) -> Option<RValue>

pub fn set(&self, name: String, value: RValue)

pub fn set_super(&self, name: String, value: RValue)

Super-assignment: assign in parent environment (<<-)

Walks up the environment chain looking for an existing binding. If found, overwrites it in place. If not found, creates the binding in the global environment (not base) — R treats global as the creation boundary for <<-.

fn is_global(&self) -> bool

Returns true if this is the global environment.

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

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

pub fn push_on_exit(&self, expr: Expr, add: bool, after: bool)

Register an expression to run when this frame exits (on.exit). If add is false (default), replaces existing on.exit expressions. If after is true (default), appends after existing; if false, prepends before.

pub fn take_on_exit(&self) -> Vec<Expr>

Take all on.exit expressions (empties the list).

pub fn peek_on_exit(&self) -> Vec<Expr>

Return the currently registered on.exit expressions without clearing them.

pub fn new_empty() -> Self

pub fn ls(&self) -> Vec<String>

pub fn local_bindings(&self) -> Vec<(String, RValue)>

Return all local (non-active) bindings as name-value pairs, sorted by name.

pub fn name(&self) -> Option<String>

pub fn set_name(&self, name: String)

pub fn parent(&self) -> Option<Environment>

pub fn set_parent(&self, parent: Option<Environment>)

Set the parent (enclosing) environment.

pub fn get_function(&self, name: &str) -> Option<RValue>

Look up a name, skipping non-function values (like R’s findFun). This implements R’s behavior where c(1,2) still calls the c function even if c has been assigned a non-function value in the current env.

pub fn lock(&self, bindings: bool)

Lock the environment so no new bindings can be added. If bindings is true, also lock all existing bindings.

pub fn is_locked(&self) -> bool

Return whether this environment is locked.

pub fn lock_binding(&self, name: &str)

Lock a specific binding in this environment.

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

Return whether a specific binding is locked.

pub fn set_active_binding(&self, name: String, fun: RValue)

Register an active binding: a zero-argument function called on every access.

pub fn get_local_active_binding(&self, name: &str) -> Option<RValue>

Get the function for an active binding in this environment (local only).

pub fn get_active_binding(&self, name: &str) -> Option<RValue>

Walk the environment chain looking for an active binding. Returns the function if found.

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

Check if a name is an active binding (walks the chain).

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

Check if a name is a local active binding (does not walk the chain).

pub fn set_promise_expr(&self, name: String, expr: Expr)

Store the original unevaluated expression for a function parameter. Used by substitute() to recover the source expression.

pub fn get_promise_expr(&self, name: &str) -> Option<Expr>

Get the original unevaluated expression for a function parameter. Checks this environment only (local), not parents.

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 CoerceArg for Environment

fn coerce(val: &RValue, param_name: &str) -> Result<Self, RError>

impl Debug for Environment

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

Formats the value using the given formatter.