Struct melon::VM

pub struct VM {
    pub mem: Vec<u8>,
    pub return_value: u8,
    // some fields omitted
}

The state of the VM

Fields

mem: Vec<u8>

The memory allocated and used by the VM

return_value: u8

The return value of the VM

Methods

impl VM

pub fn exec<T: System>(
    &mut self,
    program: &Program,
    system: &mut T
) -> Result<u8>

Executes the given program using the given system and returns the program's exit status

pub fn halt(&mut self)

Stops execution and shuts down the VM

pub fn read_u8(&mut self, addr: Address) -> Result<u8>

Returns the u8 at the given address

pub fn write_u8(&mut self, addr: Address, value: u8) -> Result<()>

Writes the given u8 to the given address

pub fn read_u16(&mut self, addr: Address) -> Result<u16>

Returns the u16 at the given address

pub fn write_u16(&mut self, addr: Address, value: u16) -> Result<()>

Writes the given u16 to the given address

pub fn pop_u8(&mut self) -> Result<u8>

Helper method for popping a u8 value off the stack

pub fn pop_u16(&mut self) -> Result<u16>

Helper method for popping a u16 value off the stack

pub fn pop_i8(&mut self) -> Result<i8>

Helper method for popping a i8 value off the stack

pub fn pop_i16(&mut self) -> Result<i16>

Helper method for popping a i16 value off the stack

pub fn pop_u8_lr(&mut self) -> Result<(u8, u8)>

Returns two u8 values as (left-hand-side, right-hand-side)

pub fn pop_u16_lr(&mut self) -> Result<(u16, u16)>

Returns two u16 values as (left-hand-side, right-hand-side)

pub fn pop_i8_lr(&mut self) -> Result<(i8, i8)>

Returns two i8 values as (left-hand-side, right-hand-side)

pub fn pop_i16_lr(&mut self) -> Result<(i16, i16)>

Returns two i16 values as (left-hand-side, right-hand-side)

pub fn add(&mut self, ty: IntegerType) -> Result<()>

Pops two values of the given type off the stack, adds them together and pushes the result back on the stack

pub fn sub(&mut self, ty: IntegerType) -> Result<()>

Pops two values of the given type off the stack, subtracts the second from the first and pushes the result back on the stack

pub fn mul(&mut self, ty: IntegerType) -> Result<()>

Pops two values of the given type off the stack, multiplies them and pushes the result back on the stack

pub fn div(&mut self, ty: IntegerType) -> Result<()>

Pops two values of the given type off the stack, divides the first through the second and pushes the result back on the stack

pub fn shr(&mut self, ty: IntegerType) -> Result<()>

Pops two values of the given type off the stack, uses the second one to shift the bits of the first one to the right and pushes the result back onto the stack

pub fn shl(&mut self, ty: IntegerType) -> Result<()>

Pops two values of the given type off the stack, uses the second one to shift the bits of the first one to the left and pushes the result back onto the stack

pub fn and(&mut self, ty: IntegerType) -> Result<()>

Pops two values of the given type off the stack, applies a bitwise and to both and pushes the result back onto the stack

pub fn or(&mut self, ty: IntegerType) -> Result<()>

Pops two values of the given type off the stack, applies a bitwise or to both and pushes the result back onto the stack

pub fn xor(&mut self, ty: IntegerType) -> Result<()>

Pops two values of the given type off the stack, applies a bitwise or to both and pushes the result back onto the stack

pub fn not(&mut self, ty: IntegerType) -> Result<()>

Applies a bitwise not operation to the top stack value

pub fn neg(&mut self, ty: IntegerType) -> Result<()>

Applies a negation on the top stack value

pub fn cmp(&mut self, ty: IntegerType) -> Result<()>

Compares the top two values of the stack by applying a subtraction on them and saving the result in the cmp register

pub fn inc(&mut self, ty: IntegerType) -> Result<()>

Increments the top stack value

pub fn dec(&mut self, ty: IntegerType) -> Result<()>

Decrements the top stack value

pub fn u8_promote(&mut self) -> Result<()>

Converts a u8 to a u16

pub fn u16_demote(&mut self) -> Result<()>

Converts a u16 to a u8

pub fn i8_promote(&mut self) -> Result<()>

Converts a i8 to a i16

pub fn i16_demote(&mut self) -> Result<()>

Converts a i16 to a i8

pub fn push_const_u8(&mut self, value: u8) -> Result<()>

Pushes the given u8 onto the stack

pub fn push_const_u16(&mut self, value: u16) -> Result<()>

Pushes the given u16 onto the stack

pub fn push_const_i8(&mut self, value: i8) -> Result<()>

Pushes the given i8 onto the stack

pub fn push_const_i16(&mut self, value: i16) -> Result<()>

Pushes the given i16 onto the stack

pub fn load_reg(&mut self, reg: Register) -> Result<()>

Loads the value from the given register and pushes it onto the stack

pub fn load(&mut self, ty: IntegerType, addr: Address) -> Result<()>

Loads the value from the given address and pushes it to the stack

pub fn load_indirect(&mut self, ty: IntegerType) -> Result<()>

Like load but takes the address off the stack before storing

pub fn store(&mut self, ty: IntegerType, addr: Address) -> Result<()>

Takes the top value off the stack and stores it at the given address

pub fn store_indirect(&mut self, ty: IntegerType) -> Result<()>

Like store but takes the address off the stack before storing

pub fn dup(&mut self, ty: IntegerType) -> Result<()>

Duplicates the top stack value and pushes it onto the stack

pub fn drop(&mut self, ty: IntegerType) -> Result<()>

Discards the top stack value

pub fn call(&mut self, addr: Address) -> Result<()>

Calls the function at the given address

pub fn ret(&mut self) -> Result<()>

Returns from a function call

pub fn alloc(&mut self, amount: u16) -> Result<()>

Allocates the given number of bytes in the heap

pub fn free(&mut self) -> Result<()>

Undos the last allocation and frees the memory

pub fn jmp(&mut self, forward: bool, addr: Address) -> Result<()>

Jumps unconditionally in the given direction

pub fn jneq(&mut self, forward: bool, addr: Address) -> Result<()>

Jumps in the given direction if the compared values are not equal

pub fn jeq(&mut self, forward: bool, addr: Address) -> Result<()>

Jumps in the given direction if the compared values are equal

pub fn jlt(&mut self, forward: bool, addr: Address) -> Result<()>

Jumps in the given direction if value a is less than value b

pub fn jlt_eq(&mut self, forward: bool, addr: Address) -> Result<()>

Jumps in the given direction if value a is less than or equal to value b

pub fn jgt(&mut self, forward: bool, addr: Address) -> Result<()>

Jumps in the given direction if value a is greater than value b

pub fn jgt_eq(&mut self, forward: bool, addr: Address) -> Result<()>

Jumps in the given direction if value a is greater than or equal to value b

Trait Implementations

impl Clone for VM

fn clone(&self) -> VM

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for VM

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

Formats the value using the given formatter.

impl Default for VM

fn default() -> VM

Returns the "default value" for a type.

impl<'de> Deserialize<'de> for VM

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl Serialize for VM

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.