Struct PrintableErrno 

pub struct PrintableErrno<S: AsRef<str>> { /* private fields */ }

This is the base struct containing basic error information. Unless you call printable_error or you unwrap the error on a Result containing a PrintableErrno, you probably won’t use this directly.

When printed, the error message will look like the following:

• If there is an associated errno: $program_name: $message: ${errno.desc()}
• If there is no errno (called from printable_error): $program_name: $message

Printed error tries to follow perror(3p)’s format with the addition of the program name.

Implementations

impl<S: AsRef<str>> PrintableErrno<S>

pub fn bail(self, exit_code: i32) -> ExitError<S>

Attach an exit code to the Error. Useful for bubbling up errors from a deep function using the ? operator.

pub fn eprint(self)

Print the error to stderr.

pub fn eprint_signalsafe(&self)

Same as PrintableErrno::eprint, but attempts to write() directly to stderr and not to call any non-signal-safe functions. Useful when one is the child in a multi-threaded program after a call to fork().

Note

No allocations should be made in this function in order to comply with fork()s contract of signal-safety.

Safety

The caller must ensure that stderr (fd 2) remains open for the entirety of this function call. A naive attempt at detecting a closed file descriptor is made on first write. However, any subsequent writes may silently fail if stderr is closed while this function is running.

Trait Implementations

impl<S: Debug + AsRef<str>> Debug for PrintableErrno<S>

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

Formats the value using the given formatter.

impl<S: AsRef<str>> Display for PrintableErrno<S>

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

Formats the value using the given formatter.

impl<S: AsRef<str> + Debug> Error for PrintableErrno<S>

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<PrintableErrno<&str>> for PrintableErrno<String>

fn from(item: PrintableErrno<&str>) -> Self

Converts to this type from the input type.