Struct Vm

pub struct Vm { /* private fields */ }

Available on crate feature interp only.

A virtual machine for interpreting Pulley bytecode.

Implementations

impl Vm

pub fn new() -> Self

Create a new virtual machine with the default stack size.

pub fn with_stack(stack: Vec<u8>) -> Self

Create a new virtual machine with the given stack.

pub fn state(&self) -> &MachineState

Get a shared reference to this VM’s machine state.

pub fn state_mut(&mut self) -> &mut MachineState

Get an exclusive reference to this VM’s machine state.

pub fn into_stack(self) -> Vec<u8>

Consumer this VM and return its stack storage.

pub unsafe fn call<'a>( &'a mut self, func: NonNull<u8>, args: &[Val], rets: impl IntoIterator<Item = RegType> + 'a, ) -> Result<impl Iterator<Item = Val> + 'a, NonNull<u8>>

Call a bytecode function.

The given func must point to the beginning of a valid Pulley bytecode function.

The given args must match the number and type of arguments that function expects.

The given rets must match the function’s actual return types.

Returns either the resulting values, or the PC at which a trap was raised.

Trait Implementations

impl Default for Vm

fn default() -> Self

Returns the “default value” for a type.