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

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§

source§

impl Error

source

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

Returns a string describing the error.

source§

impl Error

source

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.

source

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§

source§

impl Clone for Error

source§

fn clone(&self) -> Error

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl Debug for Error

source§

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

Formats the value using the given formatter. Read more
source§

impl Display for Error

source§

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

Formats the value using the given formatter. Read more
source§

impl Error for Error

1.30.0 · source§

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

The lower-level source of this error, if any. Read more
1.0.0 · source§

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()
1.0.0 · source§

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

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting
source§

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. Read more
source§

impl From<MethodCallError<'_>> for Error

source§

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

Converts to this type from the input type.
source§

impl Hash for Error

source§

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

Feeds this value into the given Hasher. Read more
1.3.0 · source§

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

Feeds a slice of this type into the given Hasher. Read more
source§

impl PartialEq for Error

source§

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

This method tests for self and other values to be equal, and is used by ==.
1.0.0 · source§

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

impl TryFrom<Error> for MethodCallError<'static>

§

type Error = ()

The type returned in the event of a conversion error.
source§

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

Performs the conversion.
source§

impl Copy for Error

source§

impl Eq for Error

source§

impl StructuralEq for Error

source§

impl StructuralPartialEq for Error

Auto Trait Implementations§

§

impl RefUnwindSafe for Error

§

impl Send for Error

§

impl Sync for Error

§

impl Unpin for Error

§

impl UnwindSafe for Error

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T> ToString for T
where T: Display + ?Sized,

source§

default fn to_string(&self) -> String

Converts the given value to a String. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.