Enum Error 

pub enum Error {
    CborDecode,
    BufferTooShort,
    NoSuchComponent,
    NoSuchMethod,
    BadParameters,
    QueueFull,
    QueueEmpty,
    BadDescriptor,
    TooManyDescriptors,
    Other,
    Unknown,
}

The errors that a system call can return.

Variants

CborDecode

A CBOR data item is invalid CBOR or encodes an unsupported type or value.

BufferTooShort

A buffer provided for the syscall to write into is too short.

NoSuchComponent

A component UUID refers to a component that does not exist or cannot be accessed.

NoSuchMethod

A method invocation refers to a method that does not exist.

BadParameters

The parameters are incorrect in a way that does not have a more specific error code.

QueueFull

A queue is full.

QueueEmpty

A queue is empty.

BadDescriptor

A descriptor is negative or not open.

TooManyDescriptors

There are too many open descriptors.

Other

The operation failed for an otherwise unspecified reason.

Unknown

A system call returned an error code that does not correspond to any known value.

It is likely that OC-Wasm has been updated to a version which adds new error codes, and OC-Wasm-Safe has not been updated to match.

Implementations

impl Error

pub fn as_str(self) -> &'static str

Returns a string describing the error.

impl Error

pub fn from_isize(value: isize) -> Result<usize>

Checks a system call return value of type isize for an error value.

Returns a Result containing an Error if the value is negative, or the original value if it was nonnegative.

Errors

This function fails if the parameter is negative, decoding the represented error code.

Panics

This function panics if the syscall error code is MemoryFault or StringDecode. These syscall errors should be impossible in safe code because the type system prohibits them: MemoryFault should be impossible because all memory regions are taken as slices which are always valid, and StringDecode should be impossible because all strings are taken as string-slices (&str) which are always valid UTF-8.

pub fn from_i32(value: i32) -> Result<u32>

Checks a system call return value of type i32 for an error value.

Returns a Result containing an Error if the value is negative, or the original value if it was nonnegative.

Errors

This function fails if the parameter is negative, decoding the represented error code.

Panics

This function panics if the syscall error code is MemoryFault or StringDecode. These syscall errors should be impossible in safe code because the type system prohibits them: MemoryFault should be impossible because all memory regions are taken as slices which are always valid, and StringDecode should be impossible because all strings are taken as string-slices (&str) which are always valid UTF-8.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Error

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Eq for Error

impl Error for Error

Available on crate feature std only.

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

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

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

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

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

Provides type-based access to context intended for error reports.

impl From<MethodCallError<'_>> for Error

fn from(source: MethodCallError<'_>) -> Self

Converts to this type from the input type.

impl Hash for Error

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Error

fn eq(&self, other: &Error) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Error

impl TryFrom<Error> for MethodCallError<'static>

type Error = ()

The type returned in the event of a conversion error.

fn try_from(source: Error) -> Result<Self, Self::Error>

Performs the conversion.