pub struct ResumableCallHostTrap { /* private fields */ }Expand description
State required to resume a Func invocation after a host trap.
Implementations§
Source§impl ResumableCallHostTrap
impl ResumableCallHostTrap
Sourcepub fn host_func(&self) -> Func
pub fn host_func(&self) -> Func
Returns the host Func that returned the host error.
§Note
When using ResumableCallHostTrap::resume the inputs
need to match the results of this host function so that
the function invocation can properly resume. For that
number and types of the values provided must match.
Sourcepub fn host_error(&self) -> &Error
pub fn host_error(&self) -> &Error
Returns a shared reference to the encountered host error.
§Note
This is guaranteed to never be a Wasm trap.
Sourcepub fn into_host_error(self) -> Error
pub fn into_host_error(self) -> Error
Consumes self and returns the encountered host error.
§Note
This is guaranteed to never be a Wasm trap.
Sourcepub fn resume<T>(
self,
ctx: impl AsContextMut<Data = T>,
inputs: &[Val],
outputs: &mut [Val],
) -> Result<ResumableCall, Error>
pub fn resume<T>( self, ctx: impl AsContextMut<Data = T>, inputs: &[Val], outputs: &mut [Val], ) -> Result<ResumableCall, Error>
Resumes the call to the Func with the given inputs.
The result is written back into the outputs buffer upon success.
Returns a resumable handle to the function invocation upon encountering host errors with which it is possible to handle the error and continue the execution as if no error occurred.
§Errors
- If the function resumption returned a Wasm
Error. - If the types or the number of values in
inputsdoes not match the types and number of result values of the erroneous host function. - If the number of output values does not match the expected number of outputs required by the called function.