Struct lazy_errors::AdHocError

pub struct AdHocError { /* private fields */ }

A single, “one of a kind” Error, created from an ad-hoc error message, with source location information that gets added implicitly when a value of this type is constructed.

Most of the time this type is used only internally.

Values of this type get created internally when the err! macro or when Error::from_message are called.

AdHocError can be printed and supports “pretty-printing” as well:

use lazy_errors::AdHocError;

let err = AdHocError::from_message("Something went wrong");

let printed = format!("{err}");
assert_eq!(printed, "Something went wrong");

let printed = format!("{err:#}");
let printed = replace_line_numbers(&printed);
assert_eq!(printed, indoc::indoc! {"
    Something went wrong
    at src/error.rs:1234:56"});

Implementations

impl AdHocError

pub fn from_message<M: Display>(msg: M) -> Self

Creates an AdHocError from a message.

Trait Implementations

impl Debug for AdHocError

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

Formats the value using the given formatter.

impl Display for AdHocError

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

Formats the value using the given formatter.

impl Error for AdHocError

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

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 IntoEyreReport for AdHocError

fn into_eyre_report(self) -> Report

Lossy conversion to return some type, for example a non-empty list of one or more errors, from functions returning eyre::Result, i.e. Result<_, E> where E is eyre::Report.

impl Reportable for AdHocError