Struct EelProgram 

pub struct EelProgram { /* private fields */ }

One compiled EEL2 program: flat bytecode over a fixed register file.

Fixed-size at load; nothing here grows per frame.

Implementations

impl EelProgram

pub fn empty() -> Self

A program with no instructions and no registers — the identity, and what an absent section in a bundle means.

pub fn new(code: Vec<Op>, names: Vec<String>) -> Result<Self, ProgramError>

Assemble from code and register names, validating both.

The only constructor, so the invariants validate establishes hold of every EelProgram that exists.

pub fn code(&self) -> &[Op]

The instructions.

pub fn names(&self) -> &[String]

The register names, positionally.

pub fn register_count(&self) -> usize

How many registers the program declares.

pub fn stack_depth(&self) -> usize

The deepest the operand stack gets. The VM sizes its stack from this.

pub fn written_registers(&self) -> &[u16]

Every register this program can write — see the field.

pub fn register(&self, name: &str) -> Option<u16>

The index of the register called name, or None.

Called at load, never per frame. The host resolves the whole roster it cares about once and then addresses registers by index.

pub fn uses_random(&self) -> bool

Whether the program can draw from the RNG, i.e. whether its output depends on anything but its inputs and its register file.

Read by the capture harness’s determinism argument: a program that says false here is a pure function of its inputs, and one that says true is a pure function of its inputs and the VM’s seeded RNG state, which is itself reset with the preset (ADR-0051).

impl EelProgram

pub fn to_assembly(&self) -> String

This program as assembly text — the form a bundle carries.

.regs zoom rot _t0
.code
const 1.5
load 0
mul
store 0

The inverse of from_assembly, which is asserted rather than intended.

pub fn from_assembly(text: &str) -> Result<Self, ProgramError>

Decode assembly text, validating it into a program the VM may trust.

Blank lines and # comments are ignored, so a bundle stays legible.

Trait Implementations

impl Clone for EelProgram

fn clone(&self) -> EelProgram

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for EelProgram

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

Formats the value using the given formatter.

impl PartialEq for EelProgram

fn eq(&self, other: &EelProgram) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for EelProgram