Enum arboard::Error

#[non_exhaustive]
pub enum Error {
    ContentNotAvailable,
    ClipboardNotSupported,
    ClipboardOccupied,
    ConversionFailure,
    Unknown {
        description: String,
    },
}

An error that might happen during a clipboard operation.

Note that both the Display and the Debug trait is implemented for this type in such a way that they give a short human-readable description of the error; however the documentation gives a more detailed explanation for each error kind.

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.

ContentNotAvailable

The clipboard contents were not available in the requested format. This could either be due to the clipboard being empty or the clipboard contents having an incompatible format to the requested one (eg when calling get_image on text)

ClipboardNotSupported

The selected clipboard is not supported by the current configuration (system and/or environment).

This can be caused by a few conditions:

• Using the Primary clipboard with an older Wayland compositor (that doesn’t support version 2)
• Using the Secondary clipboard on Wayland

ClipboardOccupied

The native clipboard is not accessible due to being held by an other party.

This “other party” could be a different process or it could be within the same program. So for example you may get this error when trying to interact with the clipboard from multiple threads at once.

Note that it’s OK to have multiple Clipboard instances. The underlying implementation will make sure that the native clipboard is only opened for transferring data and then closed as soon as possible.

ConversionFailure

The image or the text that was about the be transferred to/from the clipboard could not be converted to the appropriate format.

Unknown

Any error that doesn’t fit the other error types.

The description field is only meant to help the developer and should not be relied on as a means to identify an error case during runtime.

Fields

description: String

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)>

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.