Struct Frame 

pub struct Frame {
    pub function_idx: usize,
    pub ip: usize,
    pub bp: usize,
    pub locals: HashMap<String, Value>,
    pub return_ip: Option<usize>,
    pub return_function: Option<usize>,
}

Represents a call frame in the VM’s call stack.

Each function call creates a new frame that contains:

• The function being executed
• The instruction pointer within that function
• Local variables
• The stack base pointer for this frame

Fields

function_idx: usize

Index of the function being executed

ip: usize

Current instruction pointer within the function

bp: usize

Base pointer in the stack for this frame

locals: HashMap<String, Value>

Local variables for this frame

return_ip: Option<usize>

Return address (instruction pointer to return to)

return_function: Option<usize>

Function index to return to

Implementations

impl Frame

pub fn new(function_idx: usize, bp: usize) -> Self

Creates a new call frame for a function call

pub fn with_return( function_idx: usize, bp: usize, return_ip: usize, return_function: usize, ) -> Self

Creates a new call frame with return information

pub fn set_local(&mut self, name: String, value: Value)

Sets a local variable in this frame

pub fn get_local(&self, name: &str) -> Option<&Value>

Gets a local variable from this frame

pub fn is_tail_position(&self, next_instruction: Option<&Instruction>) -> bool

Checks if this is a tail call position (i.e., the next instruction would be a return)

Trait Implementations

impl Clone for Frame

fn clone(&self) -> Frame

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Frame

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

Formats the value using the given formatter.