Enum x11rb_protocol::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.

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

Performs copy-assignment from source.

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

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

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

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

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

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

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

impl From<ParseError> for ConnectError

fn from(err: ParseError) -> Self

Converts to this type from the input type.

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 ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl Copy for ParseError

impl Eq for ParseError

impl StructuralEq for ParseError

impl StructuralPartialEq for ParseError