Struct simple_error::SimpleError

pub struct SimpleError { /* fields omitted */ }

A type that represents a simple error.

This type uses a String to store the error string, and it implements std::error::Error.

Implementations

impl SimpleError

pub fn new<T: Into<String>>(t: T) -> SimpleError

Creates a new simple error.

This function can take any type that implements Into<String>.

Examples

use self::simple_error::SimpleError;

// errors can be created from `str`
let err = SimpleError::new("an error from str");

// errors can also be created from `String`
let err = SimpleError::new(String::from("an error from String"));

pub fn from<T: Error>(t: T) -> SimpleError

Creates a new simple error from another error.

This function can take any type that implements std::error::Error. The error string will be the Display of the std::error::Error.

Examples

use self::simple_error::SimpleError;
use std::io;

// errors can be created from `io::Error`
let err = SimpleError::from(io::Error::new(io::ErrorKind::Other, "oh no"));
assert_eq!("oh no", format!("{}", err));

pub fn with<T: Error>(s: &str, t: T) -> SimpleError

Creates a new simple error from a string with another error.

This function takes a string as error and a type that implements std::error::Error as reason. The error string will be the Display of the std::error::Error prefixed with the string and ", ".

Examples

use self::simple_error::SimpleError;

let err = SimpleError::with("cannot turn on tv", SimpleError::new("remote not found"));
assert_eq!("cannot turn on tv, remote not found", format!("{}", err));

pub fn as_str(&self) -> &str

Extracts a string slice describing the error.

Examples

use self::simple_error::SimpleError;

let s = SimpleError::new("critical error");
assert_eq!("critical error", s.as_str());

Trait Implementations

impl Clone for SimpleError

pub fn clone(&self) -> SimpleError

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for SimpleError

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

Formats the value using the given formatter.

impl Display for SimpleError

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

Formats the value using the given formatter.

impl Eq for SimpleError

impl Error for SimpleError

pub fn description(&self) -> &str

👎 Deprecated since 1.42.0:

use the Display impl or to_string()

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

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

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

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

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

pub fn cause(&self) -> Option<&dyn Error>

👎 Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

impl<'a> From<&'a str> for SimpleError

pub fn from(s: &str) -> SimpleError

Performs the conversion.

impl PartialEq<SimpleError> for SimpleError

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl StructuralEq for SimpleError

impl StructuralPartialEq for SimpleError