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§

Returns a string describing the error.

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.

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§

Returns a copy of the value. Read more
Performs copy-assignment from source. Read more
Formats the value using the given formatter. Read more
Formats the value using the given formatter. Read more
The lower-level source of this error, if any. Read more
👎Deprecated since 1.42.0: use the Display impl or to_string()
👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting
🔬This is a nightly-only experimental API. (error_generic_member_access)
Provides type based access to context intended for error reports. Read more
Converts to this type from the input type.
Feeds this value into the given Hasher. Read more
Feeds a slice of this type into the given Hasher. Read more
This method tests for self and other values to be equal, and is used by ==.
This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
The type returned in the event of a conversion error.
Performs the conversion.

Auto Trait Implementations§

Blanket Implementations§

Gets the TypeId of self. Read more
Immutably borrows from an owned value. Read more
Mutably borrows from an owned value. Read more

Returns the argument unchanged.

Calls U::from(self).

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

🔬This is a nightly-only experimental API. (provide_any)
Data providers should implement this method to provide all values they are able to provide by using demand. Read more
The resulting type after obtaining ownership.
Creates owned data from borrowed data, usually by cloning. Read more
Uses borrowed data to replace owned data, usually by cloning. Read more
Converts the given value to a String. Read more
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.