Enum Error

#[non_exhaustive]
pub enum Error {
    Message(String),
    InputOutput(Arc<Error>),
    IncorrectType,
    Utf8(Utf8Error),
    PaddingNot0(u8),
    UnknownFd,
    MissingFramingOffset,
    IncompatibleFormat(Signature, Format),
    SignatureMismatch(Signature, String),
    OutOfBounds,
    MaxDepthExceeded(MaxDepthExceeded),
    SignatureParse(Error),
    EmptyStructure,
    InvalidObjectPath,
}

Error type used by zvariant API.

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.

Message(String)

Generic error. All serde errors gets transformed into this variant.

InputOutput(Arc<Error>)

Wrapper for std::io::Error

IncorrectType

Type conversions errors.

Utf8(Utf8Error)

Wrapper for std::str::Utf8Error

PaddingNot0(u8)

Non-0 padding byte(s) encountered.

UnknownFd

The deserialized file descriptor is not in the given FD index.

MissingFramingOffset

Missing framing offset at the end of a GVariant-encoded container,

IncompatibleFormat(Signature, Format)

The type (signature as first argument) being (de)serialized is not supported by the format.

SignatureMismatch(Signature, String)

The provided signature (first argument) was not valid for reading as the requested type. Details on the expected signatures are in the second argument.

OutOfBounds

Out of bounds range specified.

MaxDepthExceeded(MaxDepthExceeded)

The maximum allowed depth for containers in encoding was exceeded.

SignatureParse(Error)

Error from parsing a signature.

EmptyStructure

Attempted to create an empty structure (which is not allowed by the D-Bus specification).

InvalidObjectPath

Invalid object path.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

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 Error for Error

fn custom<T>(msg: T) -> Error

where T: Display,

Raised when there is general error when deserializing a type.

fn invalid_type(unexp: Unexpected<'_>, exp: &dyn Expected) -> Self

Raised when a Deserialize receives a type different from what it was expecting.

fn invalid_value(unexp: Unexpected<'_>, exp: &dyn Expected) -> Self

Raised when a Deserialize receives a value of the right type but that is wrong for some other reason.

fn invalid_length(len: usize, exp: &dyn Expected) -> Self

Raised when deserializing a sequence or map and the input data contains too many or too few elements.

fn unknown_variant(variant: &str, expected: &'static [&'static str]) -> Self

Raised when a Deserialize enum type received a variant with an unrecognized name.

fn unknown_field(field: &str, expected: &'static [&'static str]) -> Self

Raised when a Deserialize struct type received a field with an unrecognized name.

fn missing_field(field: &'static str) -> Self

Raised when a Deserialize struct type expected to receive a required field with a particular name but that field was not present in the input.

fn duplicate_field(field: &'static str) -> Self

Raised when a Deserialize struct type received more than one of the same field.

impl Error for Error

fn custom<T>(msg: T) -> Error

where T: Display,

Used when a Serialize implementation encounters any error while serializing a type.

impl From<Error> for Error

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(val: Error) -> Self

Converts to this type from the input type.

impl From<Infallible> for Error

fn from(i: Infallible) -> Self

Converts to this type from the input type.

impl PartialEq for Error

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.