Struct MMix 

pub struct MMix { /* private fields */ }

Implementations

impl MMix

pub fn new() -> Self

Create a new MMIX computer with all registers and memory initialized to zero.

pub fn get_register(&self, reg: u8) -> u64

Get the value of a general-purpose register.

pub fn set_register(&mut self, reg: u8, value: u64)

Set the value of a general-purpose register.

pub fn get_special(&self, reg: SpecialReg) -> u64

Get the value of a special-purpose register.

pub fn set_special(&mut self, reg: SpecialReg, value: u64)

Set the value of a special-purpose register.

pub fn read_byte(&self, addr: u64) -> u8

Read a byte from memory at the given address. Uninitialized memory reads as zero.

pub fn write_byte(&mut self, addr: u64, value: u8)

Write a byte to memory at the given address.

pub fn read_wyde(&self, addr: u64) -> u16

Read a wyde (2 bytes) from memory starting at the given address.

pub fn write_wyde(&mut self, addr: u64, value: u16)

Write a wyde (2 bytes) to memory starting at the given address.

pub fn read_tetra(&self, addr: u64) -> u32

Read a tetra (4 bytes) from memory starting at the given address.

pub fn write_tetra(&mut self, addr: u64, value: u32)

Write a tetra (4 bytes) to memory starting at the given address.

pub fn read_octa(&self, addr: u64) -> u64

Read an octa (8 bytes) from memory starting at the given address.

pub fn write_octa(&mut self, addr: u64, value: u64)

Write an octa (8 bytes) to memory starting at the given address.

pub fn fetch_instruction(&self) -> (u8, u8, u8, u8)

Fetch the next instruction from memory and decode it. Returns (OP, X, Y, Z) where:

• OP is the opcode
• X, Y, Z are the operand bytes

pub fn get_pc(&self) -> u64

Get the current program counter.

pub fn set_pc(&mut self, pc: u64)

Set the program counter.

pub fn advance_pc(&mut self)

Advance the program counter by 4 bytes (one instruction).

pub fn get_exit_code(&self) -> u64

Get the exit code set by TRAP 0 (Halt).

pub fn execute_instruction(&mut self) -> bool

Execute a single instruction at the current program counter. Returns true if execution should continue, false if halted.

pub fn run(&mut self) -> usize

Execute instructions starting from the current PC until a halt condition. Returns the number of instructions executed.

impl MMix

pub fn display_with(&self, format: ValueFormat) -> MMixDisplay<'_>

Trait Implementations

impl Default for MMix

fn default() -> Self

Returns the “default value” for a type.

impl Display for MMix

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

Formats the value using the given formatter.