Enum quick_xml::events::attributes::AttrError

pub enum AttrError {
    ExpectedEq(usize),
    ExpectedValue(usize),
    UnquotedValue(usize),
    ExpectedQuote(usize, u8),
    Duplicated(usize, usize),
}

Errors that can be raised during parsing attributes.

Recovery position in examples shows the position from which parsing of the next attribute will be attempted.

Variants

ExpectedEq(usize)

Attribute key was not followed by =, position relative to the start of the owning tag is provided.

Example of input that raises this error:

<tag key another="attribute"/>
<!--     ^~~ error position, recovery position (8) -->

This error can be raised only when the iterator is in XML mode.

ExpectedValue(usize)

Attribute value was not found after =, position relative to the start of the owning tag is provided.

Example of input that raises this error:

<tag key = />
<!--       ^~~ error position, recovery position (10) -->

This error can be returned only for the last attribute in the list, because otherwise any content after = will be threated as a value. The XML

<tag key = another-key = "value"/>
<!--                   ^ ^- recovery position (24) -->
<!--                   '~~ error position (22) -->

will be treated as Attribute { key = b"key", value = b"another-key" } and or Attribute is returned, or AttrError::UnquotedValue is raised, depending on the parsing mode.

UnquotedValue(usize)

Attribute value is not quoted, position relative to the start of the owning tag is provided.

Example of input that raises this error:

<tag key = value />
<!--       ^    ^~~ recovery position (15) -->
<!--       '~~ error position (10) -->

This error can be raised only when the iterator is in XML mode.

ExpectedQuote(usize, u8)

Attribute value was not finished with a matching quote, position relative to the start of owning tag and a quote is provided. That position is always a last character in the tag content.

Example of input that raises this error:

<tag key = "value  />
<tag key = 'value  />
<!--               ^~~ error position, recovery position (18) -->

This error can be returned only for the last attribute in the list, because all input was consumed during scanning for a quote.

Duplicated(usize, usize)

An attribute with the same name was already encountered. Two parameters define (1) the error position relative to the start of the owning tag for a new attribute and (2) the start position of a previously encountered attribute with the same name.

Example of input that raises this error:

<tag key = 'value'  key="value2" attr3='value3' />
<!-- ^              ^            ^~~ recovery position (32) -->
<!-- |              '~~ error position (19) -->
<!-- '~~ previous position (4) -->

This error is returned only when Attributes::with_checks() is set to true (that is default behavior).

Trait Implementations

impl Debug for AttrError

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

Formats the value using the given formatter.

impl Display for AttrError

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

Formats the value using the given formatter.

impl Error for AttrError

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

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 self, demand: &mut Demand<'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 DeError

fn from(e: AttrError) -> Self

Converts to this type from the input type.

impl From<AttrError> for Error

fn from(error: AttrError) -> Self

Converts to this type from the input type.

impl PartialEq<AttrError> for AttrError

fn eq(&self, other: &AttrError) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for AttrError