Enum runa_core::error::Error

pub enum Error {
    Deserialization(Error),
    Io(Error),
    IdExists(u32),
    InvalidObject(u32),
    UnknownGlobal(u32),
    UnknownObject(u32),
    UnknownError(&'static str),
    UnknownFatalError(&'static str),
    NotImplemented(&'static str),
    Custom {
        source: Box<dyn Error + Send + Sync + 'static>,
        object_id_and_code: Option<(u32, u32)>,
        is_fatal: bool,
    },
}

Common errors that can occur when handling client requests

Variants

Deserialization(Error)

Failed to deserialize a message

Io(Error)

I/O error

IdExists(u32)

Client tried to use an ID that is already in use

InvalidObject(u32)

Client tried to use an object that’s not suitable for the request

UnknownGlobal(u32)

Client tried to use an unknown global

UnknownObject(u32)

Client tried to use an unknown object

UnknownError(&'static str)

Unknown error

UnknownFatalError(&'static str)

Unknown error that is fatal

NotImplemented(&'static str)

Client tried to invoke an unimplemented method

Custom

Fields

source: Box<dyn Error + Send + Sync + 'static>

The source error

object_id_and_code: Option<(u32, u32)>

The ID of the object that caused the error, and the wayland error code If not None, an error will be sent to the client.

is_fatal: bool

Whehther the client should be disconnected

Custom error defined by external object implementations

Implementations

impl Error

pub fn custom<E>(e: E) -> Selfwhere E: ProtocolError + Send + Sync + 'static,

Create a new error from a custom error type

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, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

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, demand: &mut Demand<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type based access to context intended for error reports.

impl From<Box<dyn Error + Sync + Send + 'static, Global>> for Error

fn from(e: Box<dyn Error + Send + Sync + 'static>) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<GetError> for Error

fn from(e: GetError) -> Self

Converts to this type from the input type.

impl From<Infallible> for Error

fn from(f: Infallible) -> Self

Converts to this type from the input type.

impl ProtocolError for Error

fn wayland_error(&self) -> Option<(u32, u32)>

Returns an object id and a wayland error code associated with this error, in that order. If not None, an error event will be sent to the client.

fn fatal(&self) -> bool

Returns whether this error is fatal. If true, the client should be disconnected.