Struct wasmtime::Trap

pub struct Trap { /* fields omitted */ }

A struct representing an aborted instruction execution, with a message indicating the cause.

Implementations

impl Trap

pub fn new<I: Into<String>>(message: I) -> Self

Creates a new Trap with message.

Example

let trap = wasmtime::Trap::new("unexpected error");
assert!(trap.to_string().contains("unexpected error"));

pub fn i32_exit(status: i32) -> Self

Creates a new Trap representing an explicit program exit with a classic i32 exit status value.

pub fn i32_exit_status(&self) -> Option<i32>

If the trap was the result of an explicit program exit with a classic i32 exit status value, return the value, otherwise return None.

pub fn trace(&self) -> &[FrameInfo]

Returns a list of function frames in WebAssembly code that led to this trap happening.

pub fn trap_code(&self) -> Option<TrapCode>

Code of a trap that happened while executing a WASM instruction. If the trap was triggered by a host export this will be None.

Trait Implementations

impl Clone for Trap

fn clone(&self) -> Trap

Returns a copy of the value.

pub fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Trap

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for Trap

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for Trap

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any.

pub fn backtrace(&self) -> Option<&Backtrace>

🔬 This is a nightly-only experimental API. (backtrace)

Returns a stack backtrace, if available, of where this error occurred.

pub fn description(&self) -> &str

👎 Deprecated since 1.42.0:

use the Display impl or to_string()

pub fn cause(&self) -> Option<&dyn Error>

👎 Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

impl From<Box<dyn Error + 'static + Send + Sync, Global>> for Trap

fn from(e: Box<dyn Error + Send + Sync>) -> Trap

Performs the conversion.

impl From<Error> for Trap

fn from(e: Error) -> Trap

Performs the conversion.