Struct grid_sdk::error::InternalError

pub struct InternalError { /* fields omitted */ }

An error which is returned for reasons internal to the function.

This error is produced when a failure occurred within the function but the failure is due to an internal implementation detail of the function. This generally means that there is no specific information which can be returned that would help the caller of the function recover or otherwise take action.

Implementations

impl InternalError

pub fn from_source(source: Box<dyn Error>) -> Self

Constructs a new InternalError from a specified source error.

The implementation of std::fmt::Display for this error will simply pass through the display of the source message unmodified.

Examples

use grid_sdk::error::InternalError;

let io_err = std::io::Error::new(std::io::ErrorKind::Other, "io error");
let internal_error = InternalError::from_source(Box::new(io_err));
assert_eq!(format!("{}", internal_error), "io error");

pub fn from_source_with_message(source: Box<dyn Error>, message: String) -> Self

Constructs a new InternalError from a specified source error and message string.

The implementation of std::fmt::Display for this error will be the message string provided.

Examples

use grid_sdk::error::InternalError;

let io_err = std::io::Error::new(std::io::ErrorKind::Other, "io error");
let internal_error = InternalError::from_source_with_message(Box::new(io_err), "oops".to_string());
assert_eq!(format!("{}", internal_error), "oops");

pub fn from_source_with_prefix(source: Box<dyn Error>, prefix: String) -> Self

Constructs a new InternalError from a specified source error and prefix string.

The implementation of std::fmt::Display for this error will be constructed from the prefix and source message’s display following the format of format!("{}: {}", prefix, source).

Examples

use grid_sdk::error::InternalError;

let io_err = std::io::Error::new(std::io::ErrorKind::Other, "io error");
let internal_error = InternalError::from_source_with_prefix(Box::new(io_err), "Could not open file".to_string());
assert_eq!(format!("{}", internal_error), "Could not open file: io error");

pub fn with_message(message: String) -> Self

Constructs a new InternalError with a specified message string.

The implementation of std::fmt::Display for this error will be the message string provided.

Examples

use grid_sdk::error::InternalError;

let internal_error = InternalError::with_message("oops".to_string());
assert_eq!(format!("{}", internal_error), "oops");

Trait Implementations

impl Debug for InternalError

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

Formats the value using the given formatter.

impl Display for InternalError

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

Formats the value using the given formatter.

impl Error for InternalError

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

The lower-level source of this error, if any.

fn backtrace(&self) -> Option<&Backtrace>

🔬 This is a nightly-only experimental API. (backtrace)

Returns a stack backtrace, if available, of where this error occurred.

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