Enum OcasError 

#[non_exhaustive]
pub enum OcasError {
    ParseError {
        message: String,
        span: Option<(usize, usize)>,
    },
    DomainError {
        expected: String,
        found: String,
    },
    NumericOverflow,
    UnsupportedOperation {
        message: String,
    },
    BackendError {
        backend: String,
        message: String,
    },
    InvalidArgument {
        name: String,
        reason: String,
    },
    OutOfFuel,
}

The primary error type returned by oCAS operations.

Example

use ocas_core::error::OcasError;

let err = OcasError::ParseError {
    message: "unexpected token".into(),
    span: Some((0, 3)),
};
assert_eq!(err.to_string(), "parse error at bytes 0..3: unexpected token");

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

ParseError

A parsing error with an optional source span.

Fields

message: String

Human-readable error message.

span: Option<(usize, usize)>

Optional byte offset into the source string.

DomainError

An operation was requested on an incompatible domain.

Fields

expected: String

Expected domain or type.

found: String

Actual value or type encountered.

NumericOverflow

A numeric overflow or underflow occurred.

UnsupportedOperation

The requested operation is not yet implemented or supported.

Fields

message: String

Description of the unsupported operation.

BackendError

A backend library returned an error.

Fields

backend: String

Name of the backend.

message: String

Backend-specific error message.

InvalidArgument

An invalid argument was supplied.

Fields

name: String

Name of the argument.

reason: String

Reason the argument is invalid.

OutOfFuel

A resource budget (crate::fuel::Fuel) was exhausted before the operation could complete. Retrying with a larger budget (or no budget) will resume from scratch.

Trait Implementations

impl Clone for OcasError

fn clone(&self) -> OcasError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OcasError

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

Formats the value using the given formatter.

impl Display for OcasError

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

Formats the value using the given formatter.

impl Error for OcasError

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 PartialEq for OcasError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for OcasError