Enum 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<(), Error>

Formats the value using the given formatter.

impl Display for ParseError

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

Formats the value using the given formatter.

impl Error for ParseError

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.

impl From<ParseError> for ConnectError

fn from(err: ParseError) -> ConnectError

Converts to this type from the input type.

impl From<ParseError> for ConnectionError

fn from(err: ParseError) -> Self

Converts to this type from the input type.

impl From<ParseError> for ReplyError

fn from(err: ParseError) -> Self

Converts to this type from the input type.

impl From<ParseError> for ReplyOrIdError

fn from(err: ParseError) -> Self

Converts to this type from the input type.

impl PartialEq for ParseError

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for ParseError

impl Eq for ParseError

impl StructuralPartialEq for ParseError