Parse Method

The parse method is the inverse of stringify. It allows you to convert human-readable LightVM instruction strings back into executable bytecode structures. This is essential when you want to write your logic in a readable format and have the VM handle the compilation or translation process.

Using TypeScript

For TypeScript, you can pass your raw instruction strings directly to the parse method. This will translate your code into the structured bytecode format required by the VM.

Code

import { LightVM } from 'lightvm';

const vm = new LightVM({ caps: [] });
const tools = vm.tools();

const strVal = `
  push 5; ;; IP=0
  val x; ;; IP=1
  set x; ;; IP=2
`;

const parsed = tools.parseLTC(strVal);

console.log(parsed);

Using Rust

In Rust, the parse method allows you to take raw instruction strings and convert them into the internal VM representation, making it easy to bridge human-written scripts with your Rust-based VM backend.

Code

use lightvm::LightVM;
use lightvm::types::{vmconfig::VmConfig};

fn main() {
  let mut vm = LightVM::new(VmConfig {
    caps: vec![],
    ..Default::default()
  });
  let tools = vm.tools();

  let str_val = r#"
    push 5; ;; IP=0
    val x; ;; IP=1
    set x; ;; IP=2
  "#;

  let parsed = tools.parse_ltc(str_val);

  println!("{:#}", parsed.clone());
}

INFO

Capability Required: no specific capability