Enum IllFormedError 

#[non_exhaustive]
pub enum IllFormedError {
    MissingDeclVersion(Option<String>),
    UnknownVersion,
    MissingDoctypeName,
    MissingEndTag(String),
    UnmatchedEndTag(String),
    MismatchedEndTag {
        expected: String,
        found: String,
    },
    DoubleHyphenInComment,
    UnclosedReference,
}

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

These errors are not fatal: parsing can continue after encountering one.

Marked #[non_exhaustive] so that adding a new ill-formedness diagnostic in a future release is not a breaking change for callers who match on this type.

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.

MissingDeclVersion(Option<String>)

A version attribute was not found in an XML declaration or is not the first attribute. Contains the name of the found attribute, if any.

UnknownVersion

The XML version specified in the declaration is neither 1.0 nor 1.1.

MissingDoctypeName

A document type definition (<!DOCTYPE foo>) does not contain a name.

MissingEndTag(String)

An end tag was not found while reading a sub-tree of elements because an EOF was encountered.

UnmatchedEndTag(String)

An end tag was encountered without a corresponding open tag at the same level of the hierarchy.

MismatchedEndTag

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

Fields

expected: String

Name of the open tag that is expected to be closed.

found: String

Name of the tag that was actually closed.

DoubleHyphenInComment

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

UnclosedReference

The parser started to parse an entity or character reference (&...;), but the input ended before the closing ; character was found.

Trait Implementations

impl Clone for IllFormedError

fn clone(&self) -> Self

Returns a duplicate 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 Eq for IllFormedError

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: &Self) -> bool

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for IllFormedError