Enum CpdbError 

#[non_exhaustive]
pub enum CpdbError {
    NullPointer,
    InvalidPrinter,
    NotFound(String),
    PrinterError(String),
    JobFailed(String),
    BackendError(String),
    FrontendError(String),
    OptionError(String),
    Utf8Error(Utf8Error),
    NulError(NulError),
    IoError(Error),
    InvalidStatus(i32),
    Unsupported,
    DbusError(String),
    FdoError(String),
}

Errors that originate from the cpdb-rs bindings.

This type is #[non_exhaustive] — match arms must include a wildcard so adding variants in future minor releases is not a breaking change.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

NullPointer

A C function returned NULL where a valid pointer was required.

InvalidPrinter

A printer object pointer is invalid or has been released.

NotFound(String)

A lookup (printer, option, media, translation, …) returned no result.

PrinterError(String)

A printer-side operation failed (set default, accept jobs, …).

JobFailed(String)

A print job submission failed.

BackendError(String)

A backend-side operation failed.

FrontendError(String)

A frontend-side operation failed (D-Bus, lifecycle, …).

OptionError(String)

A printer option could not be parsed or applied.

Utf8Error(Utf8Error)

A byte sequence returned by the backend (cpdb-libs C string or a D-Bus payload) contained invalid UTF-8.

NulError(NulError)

A Rust string contained an interior NUL byte.

IoError(Error)

An I/O error bubbled up from std::io.

InvalidStatus(i32)

An unexpected status code was returned.

Unsupported

The requested operation is not supported.

DbusError(String)

A D-Bus protocol error occurred. The inner string is a human-readable rendering (typically starts with the D-Bus error name, e.g. "org.freedesktop.DBus.Error.UnknownMethod: ...").

The variant is exposed even when the zbus-backend feature is disabled so downstream match arms remain valid across every feature combination.

FdoError(String)

A D-Bus FDO (freedesktop.org) standard error occurred. See DbusError for the rationale on the unconditional String payload.

Trait Implementations

impl Debug for CpdbError

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

Formats the value using the given formatter.

impl Display for CpdbError

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

Formats the value using the given formatter.

impl Error for CpdbError

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 CpdbError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for CpdbError

Available on crate feature zbus-backend only.

Converts a zbus::Error into a CpdbError::DbusError by rendering it with Display. Only compiled when the zbus-backend feature is enabled.

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<Error> for CpdbError

Available on crate feature zbus-backend only.

Converts a zbus::fdo::Error into a CpdbError::FdoError by rendering it with Display. Only compiled when the zbus-backend feature is enabled.

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<NulError> for CpdbError

fn from(source: NulError) -> Self

Converts to this type from the input type.

impl From<Utf8Error> for CpdbError

fn from(source: Utf8Error) -> Self

Converts to this type from the input type.