Struct ErrorWith

pub struct ErrorWith<T> { /* private fields */ }

Base error type for PAM operations (possibly with a payload)

Errors originate from the PAM library, PAM modules or helper structs in this crate. Currently no custom instances are supported.

Implementations

impl<T> ErrorWith<T>

pub const fn code(&self) -> ErrorCode

The error code.

pub fn message(&self) -> Option<&str>

Text representation of the error code, if available.

pub const fn payload(&self) -> Option<&T>

Returns a reference to an optional payload.

pub fn take_payload(&mut self) -> Option<T>

Takes the payload out of the error message.

If a payload exists in this error, it will be moved into the returned Option. All further calls to payload() and take_payload() will return None.

pub fn map<U>(self, func: impl FnOnce(T) -> U) -> ErrorWith<U>

Maps the error payload to another type

pub fn into_without_payload(self) -> Error

Removes the payload and converts to Error

impl ErrorWith<NoPayload>

pub fn into_with_payload<T>(self, payload: T) -> ErrorWith<T>

Adds the payload to the error message and returns a corresponding ErrorWith<T> instance.

pub fn into<T>(self) -> ErrorWith<T>

Converts the error message into a ErrorWith<T> instance without a payload.

Trait Implementations

impl<T: Clone> Clone for ErrorWith<T>

fn clone(&self) -> ErrorWith<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T> Debug for ErrorWith<T>

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

Formats the value using the given formatter.

impl<T> Display for ErrorWith<T>

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

Formats the value using the given formatter.

impl<T> Error for ErrorWith<T>

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<T: Send + Sync + Debug + 'static> From<ErrorWith<T>> for Error

Automatic wrapping in std::io::Error (if payload type is compatible).

fn main() -> std::result::Result<(), std::io::Error> {
    some_succeeding_pam_function()?;
    Ok(())
}

fn main() -> std::result::Result<(), std::io::Error> {
    some_failing_pam_function()?;
    Ok(())
}

fn from(error: ErrorWith<T>) -> Self

Converts to this type from the input type.

impl<T> Hash for ErrorWith<T>

where T: Hash,

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<T> PartialEq for ErrorWith<T>

where T: PartialEq,

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T> Eq for ErrorWith<T>

where T: Eq,