pub enum Error {
ContentNotAvailable,
ClipboardNotSupported,
ClipboardOccupied,
ConversionFailure,
Unknown {
description: String,
},
}
Expand description
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
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
This can happen in either of the following cases.
- When returned from
set_image
: the image going to the clipboard cannot be converted to the appropriate format. - When returned from
get_image
: the image coming from the clipboard could not be converted into theImageData
struct. - When returned from
get_text
: the text coming from the clipboard is not valid utf-8 or cannot be converted to utf-8.
Unknown
Fields
description: String
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.
Trait Implementations
sourceimpl Error for Error
impl Error for Error
1.30.0 · sourcefn source(&self) -> Option<&(dyn Error + 'static)>
fn source(&self) -> Option<&(dyn Error + 'static)>
The lower-level source of this error, if any. Read more
sourcefn backtrace(&self) -> Option<&Backtrace>
fn backtrace(&self) -> Option<&Backtrace>
backtrace
)Returns a stack backtrace, if available, of where this error occurred. Read more
1.0.0 · sourcefn description(&self) -> &str
fn description(&self) -> &str
use the Display impl or to_string()
Auto Trait Implementations
impl RefUnwindSafe for Error
impl Send for Error
impl Sync for Error
impl Unpin for Error
impl UnwindSafe for Error
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more