Struct VM

pub struct VM {
    pub operand_stack: Stack<Rc<Value>>,
    /* private fields */
}

Fields

operand_stack: Stack<Rc<Value>>

Implementations

impl VM

pub fn new(tokens: VecDeque<Token>) -> Result<VM, Error>

Constructs a new VM with the specified tokens. The tokens are usually generated through the lexer. Internally, the tokens are converted to different values by the code object.

Arguments

tokens - The tokens produced by the lexer.

pub fn repl() -> Result<VM, Error>

Creates a VM in REPL mode.

pub fn load_tokens(&mut self, tokens: VecDeque<Token>) -> Result<(), Error>

Loads the given tokens into the VM. This function does not change the operand stack or the call stack. This function can be used with the REPL mode to help facilitate a proper REPL experience.

Arguments

tokens - The tokens to load.

pub fn run(&mut self) -> Result<Option<Rc<Value>>, Error>

Runs the VM until the end of the code. This function may return an optionally value, representing the value of the last expression. It may also prematurely return an error. This may be updated to return a vector of errors.

Trait Implementations

impl Debug for VM

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

Formats the value using the given formatter.