Enum BackendError 

pub enum BackendError {
    NotSupported(String),
    InvalidArgument(String),
    ExecutionFailed(String),
}

Error originating from a compute backend.

All variants represent conditions detected by or attributed to the backend. Linalg-layer validation (nrow range, square matrix checks, etc.) should use a separate error mechanism, not BackendError.

Every variant carries its full context in its own Display message; none wraps a structured inner error. BackendError is therefore a leaf in the error chain — its source() is always None.

Variants

NotSupported(String)

The backend does not support this operation.

Returned when an operation is fundamentally unavailable on this backend (e.g., a GPU backend that lacks an eigenvalue solver). Upper layers should consider fallback strategies or alternative computation paths.

InvalidArgument(String)

The descriptor passed to the backend violates its contract.

This indicates a bug in the calling layer (typically linalg), not a user error. For example, buffer sizes inconsistent with declared dimensions. Callers should treat this as a panic-worthy condition in debug builds.

ExecutionFailed(String)

The computation failed at runtime.

The operation was supported and the arguments were valid, but execution failed due to numerical issues, resource exhaustion, or other runtime conditions (e.g., a matrix factorization that fails to converge).

Trait Implementations

impl Debug for BackendError

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

Formats the value using the given formatter.

impl Display for BackendError

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

Formats the value using the given formatter.

impl Error for BackendError

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.