Struct State

pub struct State { /* private fields */ }

A state representing the Y86 program registers: a vector representing the registers condition_code: u8 representing the current set condition codes program_map: a vector holding the byte contents of the program program_size: u64, the size of the program memory program_counter: the program counter at all times, pointing to an address in memory

Implementations

impl State

pub fn new(file_name: String) -> Result<Self, Box<dyn Error>>

Creates a new state of the program from a machine code file file_name: string representing the file name of a Y86 Machine code file

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

Retrieve the value of a register register_id: u8 representing the id of the register

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

sets the value of a register register_id: u8 representing the id of the register value: u64 representing the new value to put in the register

pub fn get_condition_code(&self) -> u8

Gets the current set condition codes

pub fn set_condition_code(&mut self, value: u8)

Sets the condition codes value: u8 representing the new value

pub fn get_program_size(&self) -> u64

Gets the program size

pub fn read_le(&self, address: u64) -> Result<u64, Box<dyn Error>>

Reads a memory address in little-endian address: u64 representing the address Returns a Result, fails if memory is out of bounds

pub fn write_le( &mut self, address: u64, value: u64, ) -> Result<(), Box<dyn Error>>

Writes to memory address in little-endian address: u64 representing the address value: u64 representing the value to insert into memory Returns a result, fails if memory is out of bounds

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

Sets the value of the program counter new_pc: u64 representing the new pc to set

pub fn get_pc(&self) -> u64

Gets the current PC

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

Reads a single byte in memory address: u64 representing the address to the value to read