Method call

pulley/src/interp.rs:69–89

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.

(
        &'a mut self,
        func: NonNull<u8>,
        args: &[Val],
        rets: T,
    )

    /// Returns either the resulting values, or the PC at which a trap was
    /// raised.
    pub unsafe fn call<'a, T>(
        &'a mut self,
        func: NonNull<u8>,
        args: &[Val],
        rets: T,
    ) -> DoneReason<impl Iterator<Item = Val> + use<'a, T>>
    where
        T: IntoIterator<Item = RegType> + 'a,
    {
        unsafe {
            let lr = self.call_start(args);

            match self.call_run(func) {
                DoneReason::ReturnToHost(()) => DoneReason::ReturnToHost(self.call_end(lr, rets)),
                DoneReason::Trap { pc, kind } => DoneReason::Trap { pc, kind },
                DoneReason::CallIndirectHost { id, resume } => {
                    DoneReason::CallIndirectHost { id, resume }
                }
            }
        }
    }

    /// Performs the initial part of [`Vm::call`] in setting up the `args`
    /// provided in registers according to Pulley's ABI.