Struct InstructionDispatcher

pub struct InstructionDispatcher;

Central instruction dispatcher for the VM

Provides a single entry point for executing all VM instructions by routing them to specialized handlers based on instruction type.

Implementations

impl InstructionDispatcher

pub fn execute_instruction<S, H, V>( instruction: &Instruction, stack: &mut S, heap: &mut H, variable_manager: &mut V, frame: &mut Frame, registers: &mut Registers, builtins: &mut Builtins, ) -> Result<Option<usize>, ExecutionError>

where S: StackOperations, H: HeapOperations, V: VariableManager,

Executes a single VM instruction

Routes the instruction to the appropriate handler based on its type. Some instructions may modify the instruction pointer, in which case the new pointer is returned.

Arguments

• instruction - The instruction to execute
• stack - The VM stack for value operations
• heap - The VM heap for object allocation
• variable_manager - Manages local and global variables
• frame - Current execution frame
• registers - VM registers including instruction pointer
• builtins - Built-in function implementations

Returns

• Ok(None) - Instruction executed normally, continue to next
• Ok(Some(ip)) - Instruction executed with jump, use new IP
• Err(ExecutionError) - Execution failed

Examples

use jetcrab::vm::executor::instruction_dispatcher::InstructionDispatcher;
use jetcrab::vm::instructions::Instruction;

match InstructionDispatcher::execute_instruction(
    &Instruction::Add,
    &mut stack,
    &mut heap,
    &mut variables,
    &mut frame,
    &mut registers,
    &mut builtins,
) {
    Ok(None) => println!("Continue to next instruction"),
    Ok(Some(ip)) => println!("Jump to instruction {}", ip),
    Err(e) => eprintln!("Execution error: {:?}", e),
}