Enum InstructionTables

pub enum InstructionTables<'a, H: ?Sized> {
    Plain(InstructionTable<H>),
    Boxed(BoxedInstructionTable<'a, H>),
}

Either a plain, static instruction table, or a boxed, dynamic instruction table.

Note that Plain variant is about 10-20% faster in Interpreter execution.

Variants

Plain(InstructionTable<H>)

Boxed(BoxedInstructionTable<'a, H>)

Implementations

impl<H: Host + ?Sized> InstructionTables<'_, H>

pub const fn new_plain<SPEC: Spec>() -> Self

Creates a plain instruction table for the given spec. See make_instruction_table.

impl<'a, H: Host + ?Sized + 'a> InstructionTables<'a, H>

pub fn insert(&mut self, opcode: u8, instruction: Instruction<H>)

Inserts the instruction into the table with the specified index.

pub fn to_boxed(&mut self) -> &mut BoxedInstructionTable<'a, H>

Converts the current instruction table to a boxed variant if it is not already, and returns a mutable reference to the boxed table.

pub fn to_boxed_with<F>(&mut self, f: F) -> &mut BoxedInstructionTable<'a, H>

where F: FnMut(Instruction<H>) -> BoxedInstruction<'a, H>,

Converts the current instruction table to a boxed variant if it is not already with f, and returns a mutable reference to the boxed table.

pub fn get_boxed(&mut self, opcode: u8) -> &mut BoxedInstruction<'a, H>

Returns a mutable reference to the boxed instruction at the specified index.

pub fn insert_boxed(&mut self, opcode: u8, instruction: BoxedInstruction<'a, H>)

Inserts a boxed instruction into the table at the specified index.

pub fn replace_boxed( &mut self, opcode: u8, instruction: BoxedInstruction<'a, H>, ) -> BoxedInstruction<'a, H>

Replaces a boxed instruction into the table at the specified index, returning the previous instruction.

pub fn update_boxed<F>(&mut self, opcode: u8, f: F)

where F: Fn(&DynInstruction<'a, H>, &mut Interpreter, &mut H) + 'a,

Updates a single instruction in the table at the specified index with f.

pub fn update_all<F>(&mut self, f: F)

where F: Fn(&DynInstruction<'a, H>, &mut Interpreter, &mut H) + Copy + 'a,

Updates every instruction in the table by calling f.