Struct rant::runtime::CallStack

pub struct CallStack<I> { /* private fields */ }

Represents a call stack and its associated locals.

Implementations

impl<I> CallStack<I>

pub fn is_empty(&self) -> bool

Returns true if the stack is empty.

pub fn len(&self) -> usize

Gets the number of frames in the stack.

pub fn pop_frame(&mut self) -> Option<StackFrame<I>>

Removes the topmost frame from the stack and returns it.

pub fn push_frame(&mut self, frame: StackFrame<I>)

Adds a frame to the top of the stack.

pub fn top_mut(&mut self) -> Option<&mut StackFrame<I>>

Returns a mutable reference to the topmost frame in the stack.

pub fn parent_mut(&mut self, depth: usize) -> Option<&mut StackFrame<I>>

Returns a mutable reference to the frame depth frames below the top of the stack.

pub fn parent(&self, depth: usize) -> Option<&StackFrame<I>>

Returns a reference to the frame depth frames below the top of the stack.

pub fn top(&self) -> Option<&StackFrame<I>>

Returna reference to the topmost frame in the stack.

pub fn gen_stack_trace(&self) -> String

Generates a stack trace string from the current state of the stack.

pub fn set_var_value(
    &mut self,
    context: &mut Rant,
    id: &str,
    access: VarAccessMode,
    val: RantValue
) -> RuntimeResult<()>

Sets a variable’s value using the specified access type.

pub fn get_var_value(
    &self,
    context: &Rant,
    id: &str,
    access: VarAccessMode,
    prefer_function: bool
) -> RuntimeResult<RantValue>

Gets a variable’s value using the specified access type.

pub fn get_var_mut<'a>(
    &'a mut self,
    context: &'a mut Rant,
    id: &str,
    access: VarAccessMode
) -> RuntimeResult<&'a mut RantVar>

Gets a mutable reference to a variable.

pub fn def_local_var(&mut self, id: &str, var: RantVar) -> RuntimeResult<()>

Defines a local variable of the specified name.

Notes

This function does not perform any identifier validation.

pub fn def_var_value(
    &mut self,
    context: &mut Rant,
    id: &str,
    access: VarAccessMode,
    val: RantValue,
    is_const: bool
) -> RuntimeResult<()>

Defines a variable of the specified name by-value.

Notes

This function does not perform any identifier validation.

pub fn taste_for_first(&self, target_flavor: StackFrameFlavor) -> Option<usize>

Scans (“tastes”) the stack from the top looking for the first occurrence of the specified frame flavor. Returns the top-relative index of the first occurrence, or None if no match was found or a stronger flavor was found first.

pub fn taste_for(&self, target_flavor: StackFrameFlavor) -> Option<usize>

Scans (“tastes”) the stack from the top looking for the first occurrence of the specified frame flavor. Returns the top-relative index of the first occurrence, or None if no match was found or another flavor was found first.

Trait Implementations

impl<I> Default for CallStack<I>

fn default() -> Self

Returns the “default value” for a type.