Enum Error

pub enum Error {
    InvalidXmlPrefixUri(TextPos),
    UnexpectedXmlUri(TextPos),
    UnexpectedXmlnsUri(TextPos),
    InvalidElementNamePrefix(TextPos),
    DuplicatedNamespace(String, TextPos),
    UnknownNamespace(String, TextPos),
    UnexpectedCloseTag {
        expected: String,
        actual: String,
        pos: TextPos,
    },
    UnexpectedEntityCloseTag(TextPos),
    UnknownEntityReference(String, TextPos),
    MalformedEntityReference(TextPos),
    EntityReferenceLoop(TextPos),
    InvalidAttributeValue(TextPos),
    DuplicatedAttribute(String, TextPos),
    NoRootNode,
    UnclosedRootNode,
    DtdDetected,
    NodesLimitReached,
    AttributesLimitReached,
    NamespacesLimitReached,
    ParserError(Error),
}

A list of all possible errors.

Variants

InvalidXmlPrefixUri(TextPos)

The xmlns:xml attribute must have an http://www.w3.org/XML/1998/namespace URI.

UnexpectedXmlUri(TextPos)

Only the xmlns:xml attribute can have the http://www.w3.org/XML/1998/namespace URI.

UnexpectedXmlnsUri(TextPos)

The http://www.w3.org/2000/xmlns/ URI must not be declared.

InvalidElementNamePrefix(TextPos)

xmlns can’t be used as an element prefix.

DuplicatedNamespace(String, TextPos)

A namespace was already defined on this element.

UnknownNamespace(String, TextPos)

An unknown namespace.

Indicates that an element or an attribute has an unknown qualified name prefix.

The first value is a prefix.

UnexpectedCloseTag

Incorrect tree structure.

Fields

expected: String

actual: String

pos: TextPos

UnexpectedEntityCloseTag(TextPos)

Entity value starts with a close tag.

Example:

<!DOCTYPE test [ <!ENTITY p '</p>'> ]>
<root>&p;</root>

UnknownEntityReference(String, TextPos)

A reference to an entity that was not defined in the DTD.

MalformedEntityReference(TextPos)

A malformed entity reference.

A & character inside an attribute value or text indicates an entity reference. Otherwise, the document is not well-formed.

EntityReferenceLoop(TextPos)

A possible entity reference loop.

The current depth limit is 10. The max number of references per reference is 255.

InvalidAttributeValue(TextPos)

Attribute value cannot have a < character.

DuplicatedAttribute(String, TextPos)

An element has a duplicated attributes.

This also includes namespaces resolving. So an element like this will lead to an error.

<e xmlns:n1='http://www.w3.org' xmlns:n2='http://www.w3.org' n1:a='b1' n2:a='b2'/>

NoRootNode

The XML document must have at least one element.

UnclosedRootNode

The root node was opened but never closed.

DtdDetected

An XML with DTD detected.

This error will be emitted only when ParsingOptions::allow_dtd is set to false.

NodesLimitReached

Indicates that the ParsingOptions::nodes_limit was reached.

AttributesLimitReached

Indicates that too many attributes were parsed.

NamespacesLimitReached

Indicates that too many namespaces were parsed.

ParserError(Error)

Errors detected by the xmlparser crate.

Implementations

impl Error

pub fn pos(&self) -> TextPos

Returns the error position.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a copy of the value.

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

Performs copy-assignment from source.

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, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for Error

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

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

Returns the lower-level source of this error, if any.

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

fn from(e: Error) -> Self

Converts to this type from the input type.

impl Hash for Error

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Error

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

impl StructuralPartialEq for Error