Struct lc3_ensemble::asm::ObjectFile

pub struct ObjectFile { /* private fields */ }

An object file.

This is the final product after assembly source code is fully assembled. This can be loaded in the simulator to run the assembled code.

Implementations

impl ObjectFile

pub fn write_bytes(&self) -> Vec<u8>

Writes an object file into a byte vector.

pub fn read_bytes(vec: &[u8]) -> Option<ObjectFile>

Reads a byte slice back into object file information, returning None if a parsing error occurs.

impl ObjectFile

pub fn new() -> Self

Creates a new, empty ObjectFile.

pub fn push( &mut self, start: u16, start_span: Range<usize>, words: Vec<Option<u16>> ) -> Result<(), AsmErr>

Add a new block to the object file, writing the provided words (words) at the provided address (start).

This will error if this block overlaps with another block already present in the object file.

pub fn iter(&self) -> impl Iterator<Item = (u16, &[Option<u16>])>

Get an iterator over all of the blocks of the object file.

pub fn len(&self) -> usize

Counts the number of blocks in this object file.

pub fn is_empty(&self) -> bool

Returns whether there are blocks in this object file.

pub fn symbol_table(&self) -> Option<&SymbolTable>

Gets the symbol table if it is present in the object file.

Trait Implementations

impl Debug for ObjectFile

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

Formats the value using the given formatter.

impl Default for ObjectFile

fn default() -> Self

Returns the “default value” for a type.