Struct JumpTable

pub struct JumpTable {
    pub(crate) jump: BTreeMap<u16, Jump>,
    pub(crate) func: BTreeMap<u32, u16>,
    pub(crate) code: Code,
}

Jump table implementation.

Fields

jump: BTreeMap<u16, Jump>

Jump table mapping program counters to jump types.

func: BTreeMap<u32, u16>

Function table mapping function indices to program counters.

code: Code

Code section associated with the jump table.

Implementations

impl JumpTable

pub fn shift_pc(&mut self, start: u16, offset: u16) -> Result<()>

Shifts the program counter for all jump items.

This function updates the program counters based on a starting point and an offset.

pub fn shift_label_pc(&mut self, start: u16, offset: u16) -> Result<()>

Shifts the program counter for labels.

This function updates the program counters of labels based on the specified start point and offset.

impl JumpTable

pub fn relocate(&mut self, buffer: &mut Buffer) -> Result<()>

Relocate program counter to all registered labels.

This function is responsible for adjusting the program counters of all jumps in the jump table. It first pre-calculates and shifts the target program counters, then iterates through each jump to relocate its target address. The function ensures that the jumps are correctly updated in the buffer, which represents the compiled code.

WARNING: This function should only be called once in the compiler. Consider moving it to the compiler’s main logic.

impl JumpTable

pub fn call(&mut self, pc: u16, func: u32)

Registers a function in the jump table.

This function associates a program counter with a function.

pub fn call_offset(&mut self, func: u32, offset: u16) -> Result<()>

Registers a program counter to the function table.

This function associates a function with a specific offset in the function table.

pub fn code_offset(&mut self, offset: u16)

Registers the start of the program counter for the code section.

pub fn ext(&mut self, pc: u16, func: ExtFunc)

Registers an external function in the jump table.

pub fn label(&mut self, pc: u16, label: u16)

Registers a label in the jump table.

pub fn merge(&mut self, table: Self, pc: u16) -> Result<()>

Merges another jump table into this one.

This function updates the program counters of the target jump table and handles any potential duplicates.

pub fn register(&mut self, pc: u16, jump: Jump)

register jump to program counter

pub fn max_target(&self) -> u16

Get the max target from the current jump table

impl JumpTable

pub fn target(&self, jump: &Jump) -> Result<u16>

Retrieves the target of a given jump.

This function returns the target program counter based on the type of jump (offset, label, function, or external function).

pub fn shift_targets(&mut self) -> Result<()>

Shifts the target program counters as a pre-calculation step.

This function calculates the target program counter from the original program counter and the target, adjusting for any offsets.

pub fn shift_target(&mut self, ptr: u16, offset: u16) -> Result<()>

Shifts the program counter of targets with the given pointer and offset.

This function handles the shifting of the code section, label targets, and function targets.

pub fn shift_func_target(&mut self, ptr: u16, offset: u16) -> Result<()>

Shifts the program counter for functions.

pub fn shift_label_target(&mut self, ptr: u16, offset: u16) -> Result<()>

Shifts the program counter for labels.

Trait Implementations

impl Clone for JumpTable

fn clone(&self) -> JumpTable

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for JumpTable

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

Formats the value using the given formatter.

impl Default for JumpTable

fn default() -> JumpTable

Returns the “default value” for a type.