Enum Error 

#[non_exhaustive]
pub enum Error {
    Xml(String),
    Io(Error),
    Eof,
    UnexpectedElement {
        expected: String,
        found: String,
    },
    MissingRequired {
        kind: &'static str,
        name: String,
        parent: String,
    },
    ParseValue {
        value: String,
        ty: &'static str,
        reason: String,
    },
    UnknownXsiType {
        value: String,
        ty: &'static str,
    },
    UnknownField {
        ty: &'static str,
        field: String,
    },
    InvalidPath {
        path: String,
        reason: String,
    },
    TypeMismatch {
        path: String,
        expected: String,
        found: String,
    },
    UnknownType(String),
    VersionAbsent(String),
    Other(String),
}

Everything that can go wrong while reading, writing or reflecting over an EnergyML object.

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.

Xml(String)

Low level XML failure reported by the parser or writer.

Io(Error)

I/O failure while reading or writing.

Eof

The document ended while a value was still being read.

UnexpectedElement

An element was found where another one was required.

Fields

expected: String

Element name the reader was looking for.

found: String

Element name actually encountered.

MissingRequired

A mandatory attribute or child element was absent.

Fields

kind: &'static str

"attribute" or "element".

name: String

Name of the missing item.

parent: String

Element that should have contained it.

ParseValue

A lexical value could not be converted to its Rust type.

Fields

value: String

The offending lexical value.

ty: &'static str

Target type name.

reason: String

Why the conversion failed.

UnknownXsiType

An xsi:type (or substituted element name) did not match any known concrete subtype of the expected abstract type.

Fields

value: String

The xsi:type value read from the document.

ty: &'static str

Abstract type being resolved.

UnknownField

Reflection was asked for a field the type does not declare.

Fields

ty: &'static str

Type being reflected over.

field: String

Requested field name.

InvalidPath

A dotted path could not be parsed.

Fields

path: String

The path as supplied by the caller.

reason: String

Why it is rejected.

TypeMismatch

A value of the wrong shape was supplied to a reflective setter.

Fields

path: String

Location of the mismatch.

expected: String

Expected kind or type name.

found: String

Kind or type name actually supplied.

UnknownType(String)

The registry does not know the requested type.

VersionAbsent(String)

The requested type belongs to a schema version the project knows but this build does not carry (see Registry::declare_absent). A refusal with its reason, not an unknown name: the data may be perfectly good. The message is the whole story and says what would bring the version.

Other(String)

Catch-all for anything not worth its own variant.

Implementations

impl Error

pub fn other(msg: impl Into<String>) -> Self

Convenience constructor for Error::Other.

pub fn parse( value: impl Into<String>, ty: &'static str, reason: impl Into<String>, ) -> Self

Convenience constructor for Error::ParseValue.

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.

impl From<AttrError> for Error

fn from(e: AttrError) -> Self

Converts to this type from the input type.

impl From<EncodingError> for Error

fn from(e: EncodingError) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<EscapeError> for Error

fn from(e: EscapeError) -> Self

Converts to this type from the input type.

impl From<FromUtf8Error> for Error

fn from(e: FromUtf8Error) -> Self

Converts to this type from the input type.

impl From<Utf8Error> for Error

fn from(e: Utf8Error) -> Self

Converts to this type from the input type.