Struct Program 

pub struct Program<'src, State> { /* private fields */ }

Type-state program using Rust’s type system to enforce correct usage.

Examples

use expr_solver::{Program, SymTable};
use rust_decimal_macros::dec;

// Compile from source
let program = Program::new_from_source("x * 2 + 1").unwrap();

// Link with symbol table
let mut table = SymTable::new();
table.add_const("x", dec!(5)).unwrap();
let linked = program.link(table).unwrap();

// Execute
assert_eq!(linked.execute().unwrap(), dec!(11));

Implementations

impl<'src> Program<'src, Compiled>

pub fn new_from_source(source: &'src str) -> Result<Self, ProgramError>

Creates a compiled program from source code.

Examples

use expr_solver::Program;

let program = Program::new_from_source("2 + 3 * 4").unwrap();

pub fn new_from_file(path: impl Into<String>) -> Result<Self, ProgramError>

Creates a compiled program from a binary file.

Examples

use expr_solver::Program;

let program = Program::new_from_file("expr.bin").unwrap();

pub fn new_from_bytecode(data: &[u8]) -> Result<Self, ProgramError>

Creates a compiled program from bytecode bytes.

Deserializes the bytecode and validates the version.

pub fn link( self, table: SymTable, ) -> Result<Program<'src, Linked>, ProgramError>

Links the bytecode with a symbol table.

Validates that all required symbols are present and compatible.

Examples

use expr_solver::{Program, SymTable};

let program = Program::new_from_source("sin(pi)").unwrap();
let linked = program.link(SymTable::stdlib()).unwrap();

pub fn symbols(&self) -> &[SymbolMetadata]

Returns the symbol metadata required by this program.

pub fn version(&self) -> &str

Returns the version of this program.

impl<'src> Program<'src, Linked>

pub fn execute(&self) -> Result<Decimal, VmError>

Executes the program and returns the result.

pub fn symtable(&self) -> &SymTable

Returns a reference to the symbol table.

pub fn symtable_mut(&mut self) -> &mut SymTable

Returns a mutable reference to the symbol table.

pub fn version(&self) -> &str

Returns the version of this program.

pub fn get_assembly(&self) -> String

Returns a human-readable assembly representation of the program.

pub fn to_bytecode(&self) -> Result<Vec<u8>, ProgramError>

Converts the program to bytecode bytes.

This involves reverse-mapping the bytecode indices back to metadata indices.

pub fn save_bytecode_to_file( &self, path: impl AsRef<Path>, ) -> Result<(), ProgramError>

Saves the program bytecode to a file.

Trait Implementations

impl<'src, State: Debug> Debug for Program<'src, State>

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

Formats the value using the given formatter.