Trait wasmi::HostError

pub trait HostError: 'static + Display + Debug + DowncastSync { }

Trait that allows the host to return custom error.

It should be useful for representing custom traps, troubles at instantiation time or other host specific conditions.

Types that implement this trait can automatically be converted to wasmi::Error and wasmi::Trap and will be represented as a boxed HostError. You can then use the various methods on wasmi::Error to get your custom error type back

Examples

use std::fmt;
use wasmi::{Error, HostError};

#[derive(Debug)]
struct MyError {
    code: u32,
}

impl fmt::Display for MyError {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        write!(f, "MyError, code={}", self.code)
    }
}

impl HostError for MyError { }

fn failable_fn() -> Result<(), Error> {
    let my_error = MyError { code: 1312 };
    // Note how you can just convert your errors to `wasmi::Error`
    Err(my_error.into())
}

// Get a reference to the concrete error
match failable_fn() {
    Err(Error::Host(host_error)) => {
        let my_error: &MyError = host_error.downcast_ref::<MyError>().unwrap();
        assert_eq!(my_error.code, 1312);
    }
    _ => panic!(),
}

// get the concrete error itself
match failable_fn() {
    Err(err) => {
        let my_error: Box<MyError> = err.try_into_host_error().unwrap().downcast::<MyError>().unwrap();
        assert_eq!(my_error.code, 1312);
    }
    _ => panic!(),
}

Implementations

impl dyn HostError

pub fn is<__T: HostError>(&self) -> bool

Returns true if the trait object wraps an object of type __T.

pub fn downcast<__T: HostError>(self: Box<Self>) -> Result<Box<__T>, Box<Self>>

Returns a boxed object from a boxed trait object if the underlying object is of type __T. Returns the original boxed trait if it isn't.

pub fn downcast_rc<__T: HostError>(self: Rc<Self>) -> Result<Rc<__T>, Rc<Self>>

Returns an Rc-ed object from an Rc-ed trait object if the underlying object is of type __T. Returns the original Rc-ed trait if it isn't.

pub fn downcast_ref<__T: HostError>(&self) -> Option<&__T>

Returns a reference to the object within the trait object if it is of type __T, or None if it isn't.

pub fn downcast_mut<__T: HostError>(&mut self) -> Option<&mut __T>

Returns a mutable reference to the object within the trait object if it is of type __T, or None if it isn't.

Implementors

Loading content...