Struct Error 

pub struct Error {
    pub category: ErrorCategory,
    pub code: ErrorCode,
    pub message: String,
    pub cause: Option<Box<Error>>,
    pub location: Option<ErrorLocation>,
}

Primary error type for the entire Rill ecosystem.

Fields

category: ErrorCategory

High-level error category for grouping.

code: ErrorCode

Machine-processable error code.

message: String

Human-readable error description.

cause: Option<Box<Error>>

Optional chained cause (builder-style via Error::with_cause).

location: Option<ErrorLocation>

Optional source location (attached via Error::at).

Implementations

impl Error

pub fn new(code: ErrorCode, message: impl Into<String>) -> Self

Create a new error with the given code and message.

pub fn with_cause(self, cause: Error) -> Self

Add a cause to this error (builder-style).

pub fn at(self, file: &'static str, line: u32, column: u32) -> Self

Attach source location info (builder-style).

pub fn root_cause(&self) -> &Error

Walk the cause chain to find the root cause.

pub fn is_realtime_critical(&self) -> bool

Whether this error is critical for a real-time thread.

pub fn is_recoverable(&self) -> bool

Whether this error is recoverable (non-critical).

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 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 Error for Error

fn source(&self) -> Option<&(dyn StdError + '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<Error> for Error

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ProcessError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<ParseFloatError> for Error

fn from(err: ParseFloatError) -> Self

Converts to this type from the input type.

impl From<ParseIntError> for Error

fn from(err: ParseIntError) -> Self

Converts to this type from the input type.

impl From<Utf8Error> for Error

fn from(err: Utf8Error) -> Self

Converts to this type from the input type.