Enum IllFormedError

pub enum IllFormedError {
    MissingDeclVersion(Option<String>),
    MissingDoctypeName,
    MissingEndTag(String),
    UnmatchedEndTag(String),
    MismatchedEndTag {
        expected: String,
        found: String,
    },
    DoubleHyphenInComment,
}

An error returned if parsed document is not well-formed, for example, an opened tag is not closed before end of input.

Those errors are not fatal: after encountering an error you can continue parsing the document.

Variants

MissingDeclVersion(Option<String>)

A version attribute was not found in an XML declaration or is not the first attribute.

According to the specification, the XML declaration (<?xml ?>) MUST contain a version attribute and it MUST be the first attribute. This error indicates, that the declaration does not contain attributes at all (if contains None) or either version attribute is not present or not the first attribute in the declaration. In the last case it contains the name of the found attribute.

MissingDoctypeName

A document type definition (DTD) does not contain a name of a root element.

According to the specification, document type definition (<!DOCTYPE foo>) MUST contain a name which defines a document type (foo). If that name is missed, this error is returned.

MissingEndTag(String)

The end tag was not found during reading of a sub-tree of elements due to encountering an EOF from the underlying reader. This error is returned from Reader::read_to_end.

UnmatchedEndTag(String)

The specified end tag was encountered without corresponding open tag at the same level of hierarchy

MismatchedEndTag

The specified end tag does not match the start tag at that nesting level.

Fields

expected: String

Name of open tag, that is expected to be closed

found: String

Name of actually closed tag

DoubleHyphenInComment

A comment contains forbidden double-hyphen (--) sequence inside.

According to the specification, for compatibility, comments MUST NOT contain double-hyphen (--) sequence, in particular, they cannot end by --->.

The quick-xml by default does not check that, because this restriction is mostly artificial, but you can enable it in the configuration.

Trait Implementations

impl Clone for IllFormedError

fn clone(&self) -> IllFormedError

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for IllFormedError

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

Formats the value using the given formatter.

impl Display for IllFormedError

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

Formats the value using the given formatter.

impl Error for IllFormedError

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

fn from(error: IllFormedError) -> Self

Creates a new Error::IllFormed from the given error

impl PartialEq for IllFormedError

fn eq(&self, other: &IllFormedError) -> 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 Eq for IllFormedError

impl StructuralPartialEq for IllFormedError