Enum roxmltree::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,
    SizeLimit,
    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 of UnexpectedCloseTag

expected: Stringactual: Stringpos: 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.

SizeLimit

The input string should be smaller than 4GiB.

ParserError(Error)

Errors detected by the xmlparser crate.

Methods

impl Error

pub fn pos(&self) -> TextPos

Returns the error position.

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

if let Err(e) = "xc".parse::<u32>() { // Print e itself, no need for description(). eprintln!("Error: {}", e); }

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

The lower-level source of this error, if any.

fn backtrace(&self) -> Option<&Backtrace>

🔬 This is a nightly-only experimental API. (backtrace)

Returns a stack backtrace, if available, of where this error occurred.

fn cause(&self) -> Option<&dyn Error>

Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

impl From<Error> for Error

fn from(e: Error) -> Self

Performs the conversion.