Struct macro_asm_builder::Assembler

pub struct Assembler<'a> {
    pub align_pattern: Vec<u8>,
    pub start_address: usize,
    pub implementation_macro: &'a dyn Fn(&Vec<String>) -> Result<Option<String>, String>,
    pub micro_assembly: &'a dyn Fn(&Vec<String>) -> Result<Vec<u8>, String>,
    /* private fields */
}

The collection of the assembly code tree and all the mutable context needed to process it

Fields

align_pattern: Vec<u8>

The pattern that will be put as padding to replace @align directives

start_address: usize

Address of the first instruction of first data in the resulting binary

implementation_macro: &'a dyn Fn(&Vec<String>) -> Result<Option<String>, String>

A function that expand implementation-specifics macros. Takes a vector of tokens from a line of code and return Ok if no macro expansion is needed, Ok to replace the text with txt, or Err to return an error message destined to the user.

micro_assembly: &'a dyn Fn(&Vec<String>) -> Result<Vec<u8>, String>

A function used to compile assembly source code into machine code. It is implementation-specific. It takes a vector if tokens from a line of code and return Ok to return the machine code or Err to return an error message destined to the user. When this function is run, all code left in the tree should be raw assembly and not macros or directive. Thus, there is no way this function can ignore code.

Implementations

impl Assembler<'_>

pub fn from_text(text: &str) -> Self

Takes some assembly code as input and set up the assembler state with it

pub fn from_file(path: &str) -> Self

Initialize the assembler state to be ready to read the input file

pub fn set_word_size(&mut self, wordsize: usize) -> Option<&str>

Set the wordsize of the assembler given it in bits. Return None if the value is valid and an error message otherwise.

pub fn add_text_before(&mut self, txt: &str, name: &str)

Add some text at the beginning of the tree.

pub fn add_text_after(&mut self, txt: &str, name: &str)

Add some text at the end of the tree.

pub fn assemble(&mut self) -> Result<Vec<u8>, String>

Perform a complete assembly process. Return a vector of bytes of the resulting binary in case of success and an error message in case of error.

pub fn label_dump(&mut self) -> String

Return a label dump of the tree