Struct sbrain::SBrainVM

pub struct SBrainVM<'a> { /* fields omitted */ }

A virtual machine modelling the SBrain Turing machine. This machine implements the specification relatively strictly, providing exactly 2^16 (65536) data and instruction cells. Thus, all pointers are 16 bits and all data is 8 bits. The main deviation from the minimum specification is the jump stack, which is indefinitely expandable.

Methods

impl<'a> SBrainVM<'a>

pub fn new(
    input: Option<&'a mut dyn Read>,
    output: Option<&'a mut dyn Write>,
    program: &[u8]
) -> Result<SBrainVM<'a>, String>

Return a new SBrainVM, with no data in any tapes. If given a None input, all reads read 0. If given a None output, all writes are discarded.

pub fn load_program(&mut self, program: &[u8]) -> Result<(), String>

Load a program tape: copy data from the given slice into the executable tape, starting at address zero. On error, the Err(s) return will contain a message describing the error.

pub fn run(&mut self, cycles: Option<u32>) -> Result<(u32, Option<u8>)>

Run the machine, until completion (cycles = None) or for n cycles (cycles = Some(n)). Return values are number of cycles run and the return code, or None if the code simply ran out of cycles.