Struct Vm 

pub struct Vm { /* private fields */ }

A unique struct containing the processors and VM context.

Implementations

impl Vm

pub fn new() -> Self

Constructs a new Vm.

Example

use vm::Vm;
let vm = Vm::new();

pub fn load_instructions( &mut self, instructions: Vec<Box<dyn Execute>>, ) -> Result<(), Error>

Moves the given Instruction slice into VmCtx memory.

Example

use vm::Vm;
let mut vm_inst = Vm::new();
let instructions = Vec::from([/* ... */]);
_ = vm_inst.load_instructions(instructions);

Errors

When the VmCtx.instructions is poisoned, InstructionsPoisoned is returned.

pub fn new_processor(&mut self) -> usize

Constructs a new processor and returns a unique handle to the processor.

The handle exists with the processor. Hence, it shares lifetimes with the Vm.

Example

use vm::Vm;

let mut vm_inst = Vm::new();
let mut prod_idx = vm_inst.new_processor();

pub fn destroy_processor(&mut self, index: usize)

Destroys the processor at the given index.

Example

use vm::Vm;

let mut vm_inst = Vm::new();
let mut prod_idx = vm_inst.new_processor();

vm_inst.destroy_processor(prod_idx);

pub fn processor(&self, index: usize) -> Result<&Processor, Error>

Returns a reference to the processor at the given index.

Example

use vm::Vm;

let mut vm_inst = Vm::new();

let prod_idx = vm_inst.new_processor();
let processor = vm_inst.processor(prod_idx).unwrap();

pub fn processor_mut(&mut self, index: usize) -> Result<&mut Processor, Error>

Returns a mutable reference to the processor at the given index.

Example

use vm::Vm;

let mut vm_inst = Vm::new();

let prod_idx = vm_inst.new_processor();
let processor = vm_inst.processor_mut(prod_idx).unwrap();

Trait Implementations

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.