Struct SymbolTable 

pub struct SymbolTable { /* private fields */ }

Stores and manages symbols defined in the assembly source.

Typically used in a two-pass assembly process:

1. Pass 1: Populate the table with label definitions and their addresses.
2. Pass 2: Use the table to resolve symbol references in instruction operands.

Implementations

impl SymbolTable

pub fn new() -> Self

Creates a new, empty symbol table.

pub fn define( &mut self, name: String, address: u32, line_number: Option<usize>, ) -> Result<(), AssemblerError>

Defines a new symbol or updates an existing one.

Arguments

• name - The name of the symbol (label).
• address - The address associated with the symbol.
• line_number - The line number where the symbol is defined (optional).

Returns

• Ok(()) - If the symbol was successfully defined.
• Err(SymbolError::Redefinition) - If a symbol with the same name already exists.

pub fn lookup(&self, name: &str) -> Option<&Symbol>

Looks up a symbol by its name.

Arguments

• name - The name of the symbol to look up.

Returns

• Some(&Symbol) - If the symbol is found.
• None - If the symbol is not defined in the table.

pub fn is_defined(&self, name: &str) -> bool

Checks if a symbol with the given name is defined.

pub fn iter(&self) -> impl Iterator<Item = (&String, &Symbol)>

Returns an iterator over the symbols in the table.

pub fn len(&self) -> usize

Returns the total number of defined symbols.

pub fn is_empty(&self) -> bool

Checks if the symbol table is empty.

pub fn add_unresolved_reference(&mut self, name: &str, line_number: usize)

Records that an unresolved symbol was encountered at a specific location. Call this during Pass 1 when an operand uses a symbol not yet defined.

pub fn check_unresolved(&self) -> Vec<(&String, &Vec<usize>)>

Checks for any symbols that were referenced but never defined after Pass 1.

Trait Implementations

impl Debug for SymbolTable

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

Formats the value using the given formatter.

impl Default for SymbolTable

fn default() -> SymbolTable

Returns the “default value” for a type.