#[non_exhaustive]pub enum Error {
ExpectedEq(usize),
ExpectedValue(usize),
UnquotedValue(usize),
ExpectedQuote(usize, u8),
Duplicated(usize, usize),
KeyNotUTF8(Utf8Error),
ValueNotUTF8(Utf8Error),
UnescapeValueFailed(EscapeError),
}Expand description
Errors that can be raised when parsing Attributes.
Recovery position in examples shows the position from which parsing of the next attribute will be attempted.
Variants (Non-exhaustive)§
This enum is marked as non-exhaustive
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) -->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 Error::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) -->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) -->KeyNotUTF8(Utf8Error)
Attribute key is not valid UTF-8.
ValueNotUTF8(Utf8Error)
Attribute value is not valid UTF-8.
UnescapeValueFailed(EscapeError)
Failed to unescape value.