Enum InstructionTables

pub enum InstructionTables<'a, H>
where
    H: ?Sized,
{
    Plain([fn(_: &mut Interpreter, _: &mut H); 256]),
    Boxed([Box<dyn Fn(&mut Interpreter, &mut H) + 'a>; 256]),
}

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([fn(_: &mut Interpreter, _: &mut H); 256])

Boxed([Box<dyn Fn(&mut Interpreter, &mut H) + 'a>; 256])

Implementations

impl<H> InstructionTables<'_, H>

where H: Host + ?Sized,

pub const fn new_plain<SPEC>() -> InstructionTables<'_, H>

where SPEC: Spec,

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

impl<'a, H> InstructionTables<'a, H>

where H: Host + 'a + ?Sized,

pub fn insert( &mut self, opcode: u8, instruction: fn(_: &mut Interpreter, _: &mut H), )

Inserts the instruction into the table with the specified index.

pub fn to_boxed( &mut self, ) -> &mut [Box<dyn Fn(&mut Interpreter, &mut H) + 'a>; 256]

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 [Box<dyn Fn(&mut Interpreter, &mut H) + 'a>; 256]

where F: FnMut(fn(_: &mut Interpreter, _: &mut H)) -> Box<dyn Fn(&mut Interpreter, &mut H) + 'a>,

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 Box<dyn Fn(&mut Interpreter, &mut H) + 'a>

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

pub fn insert_boxed( &mut self, opcode: u8, instruction: Box<dyn Fn(&mut Interpreter, &mut H) + 'a>, )

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

pub fn replace_boxed( &mut self, opcode: u8, instruction: Box<dyn Fn(&mut Interpreter, &mut H) + 'a>, ) -> Box<dyn Fn(&mut Interpreter, &mut H) + 'a>

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(&(dyn Fn(&mut Interpreter, &mut H) + 'a), &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(&(dyn Fn(&mut Interpreter, &mut H) + 'a), &mut Interpreter, &mut H) + Copy + 'a,

Updates every instruction in the table by calling f.