Enum Error

pub enum Error {
    Basic(DateTime<Local>, Box<dyn Error>),
    Custom(DateTime<Local>, String),
}

用于统一错误的枚举

Examples

let err = easy_err::Error::custom("Here is a error.");
err.report();

Variants

Basic(DateTime<Local>, Box<dyn Error>)

用于包装已经实现Error Trait的结构体或枚举

Custom(DateTime<Local>, String)

用于报告用户自定义的错误信息

Implementations

impl Error

pub fn time(&self) -> DateTime<Local>

获取错误发生的时间

Example

let time = easy_err::Error::custom("Here is a custom error.").time();
println!("{}", time);

pub fn basic(err: impl Error + 'static) -> Error

产生一个basic变体

Examples

let file = std::fs::File::open("An obvious mistake.").or_else(|err|{Err(easy_err::Error::basic(err))});
match file {
    Ok(_) => println!("Ok!"),
    Err(err) => {err.report();}
}

pub fn custom<S>(msg: S) -> Error

where S: ToString,

产生一个custom变体

Note

推荐使用 custom!() 宏代替

Examples

let custom_err = easy_err::Error::custom("Here is a error.");
custom_err.report();

pub fn report(&self) -> &Self

在标准错误流中输出一条报告信息

Examples

let custom_err = easy_err::Error::custom("Here is a error.");
custom_err.report();
// output:
// error:
//     time: <ErrorTime>
//      msg: 'Here is a error.'

pub fn panic(&self)

引发 panic!() 宏

Examples

let custom_err = easy_err::Error::custom("Here is a error.");
custom_err.panic();
// output:
// error:
//     time: <ErrorTime>
//      msg: 'Here is a error.'

pub fn log_to<P>(&self, path: P) -> &Self

where P: AsRef<Path>,

将报告信息输出至文件

Params

• path: 任何可以转换为 Path 的值

Examples

let custom_err = easy_err::Error::custom("Here is a error.");
custom_err.log_to("./log.txt");

Trait Implementations

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 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.

impl From<&Error> for Error

fn from(value: &Self) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(value: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(value: Error) -> Self

Converts to this type from the input type.