Enum x11rb::errors::ParseError

#[non_exhaustive]pub enum ParseError {
    InsufficientData,
    ConversionFailed,
    InvalidExpression,
    InvalidValue,
    MissingFileDescriptors,
}

An error occurred while parsing some data

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.

InsufficientData

Not enough data was provided.

ConversionFailed

A value did not fit.

This error can e.g. happen when a value that was received from the X11 server does not fit into an usize.

InvalidExpression

The value of an expression could not be computed.

As an example, the length of the data in xproto’s GetPropertyReply is described by value_len * (format / 8). The multiplication could cause an overflow, which would be represented by this error.

InvalidValue

A value was outside of its valid range.

There are two kinds of situations where this error can happen:

1. The protocol was violated and a nonsensical value was found.
2. The user of the API called the wrong parsing function.

Examples for the first kind of error:

• One of a set of values should be present (a <switch> in xcb-proto-speak), but none of the <cases> matched. This can e.g. happen when parsing crate::protocol::xinput::InputInfo.
• Parsing a request with a length field that is too small for the request header to fit.

Examples for the second kind of error:

• Parsing an X11 error with response_type != 0.
• Parsing an X11 reply with response_type != 1.
• Parsing an X11 request with the wrong value for its minor_opcode.

MissingFileDescriptors

Some file descriptors were expected, but not enough were received.

Trait Implementations

impl Clone for ParseError

fn clone(&self) -> ParseError

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for ParseError

impl Debug for ParseError

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

Formats the value using the given formatter.

impl Display for ParseError

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

Formats the value using the given formatter.

impl Eq for ParseError

impl Error for ParseError

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

The lower-level source of this error, if any.

pub fn backtrace(&self) -> Option<&Backtrace>

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

Returns a stack backtrace, if available, of where this error occurred.

pub fn description(&self) -> &str

👎 Deprecated since 1.42.0:

use the Display impl or to_string()

pub fn cause(&self) -> Option<&dyn Error>

👎 Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

impl From<ParseError> for ConnectError

fn from(err: ParseError) -> Self

Performs the conversion.

impl From<ParseError> for ConnectionError

fn from(err: ParseError) -> Self

Performs the conversion.

impl From<ParseError> for ReplyError

fn from(err: ParseError) -> Self

Performs the conversion.

impl From<ParseError> for ReplyOrIdError

fn from(err: ParseError) -> Self

Performs the conversion.

impl PartialEq<ParseError> for ParseError

fn eq(&self, other: &ParseError) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl StructuralEq for ParseError

impl StructuralPartialEq for ParseError