Struct Builder

pub struct Builder<'a, T: 'a + Debug + PartialEq> {
    pub instruction_table: &'a InstructionTable<T>,
    pub instructions: Vec<usize>,
    pub labels: WriteOnceTable<usize>,
    pub data: Vec<T>,
}

The builder struct.

Contains:

• an InstructionTable.
• a list of instructions that have been pushed into this builder.
• a Table of labels used for jumping.
• a list of T to be stored in the builder’s data section.

Fields

instruction_table: &'a InstructionTable<T>

instructions: Vec<usize>

labels: WriteOnceTable<usize>

data: Vec<T>

Implementations

impl<'a, T: Debug + PartialEq> Builder<'a, T>

pub fn new(instruction_table: &'a InstructionTable<T>) -> Builder<'_, T>

Create a new Builder from an InstructionTable.

pub fn push(&mut self, name: &str, args: Vec<T>)

Push an instruction into the code.

• name should match that of an instruction in the InstructionTable.
• args a vector of operands to be pushed into the builder’s data section.

pub fn label(&mut self, name: &str)

Insert a label at this point in the code.

Labels are used as targets for jumps. When you call this method a label is stored which points to the position of the next instruction.

pub fn len(&self) -> usize

Return the length of the instructions vector.

i.e. the number of instructions pushed so far.

pub fn is_empty(&self) -> bool

Return whether the Builder contains any instructions.

Trait Implementations

impl<'a, T: 'a + Debug + PartialEq> Debug for Builder<'a, T>

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

Formats the value using the given formatter.

impl<'a, T: Debug + PartialEq> From<Builder<'a, T>> for Code<T>

fn from(builder: Builder<'_, T>) -> Code<T>

Convert a Builder into Code.

This function consumes the builder and returns a Code.