Enum rxml::ResolvedEvent

pub enum ResolvedEvent {
    XMLDeclaration(EventMetrics, XMLVersion),
    StartElement(EventMetrics, ResolvedQName, HashMap<ResolvedQName, CData>),
    EndElement(EventMetrics),
    Text(EventMetrics, CData),
}

High-level, logical XML document parts

The term Event is borrowed from SAX terminology. Each ResolvedEvent refers to a bit of the XML document which has been parsed.

In contrast to the RawEvent, observing a ResolvedEvent from a NamespaceResolver which is fed by a RawParser guarantees that the XML document has been well-formed and namespace-well-formed up to this point (for the caveats about observing a RawEvent, see RawParser).

Each event has EventMetrics attached which give information about the number of bytes from the input stream used to generate the event.

Variants

XMLDeclaration(EventMetrics, XMLVersion)

Tuple Fields

0: EventMetrics

Number of bytes contributing to this event.

This includes all bytes from the opening <? until and including the closing ?>.

1: XMLVersion

XML version number

The XML declaration.

This mirrors RawEvent::XMLDeclaration.

StartElement(EventMetrics, ResolvedQName, HashMap<ResolvedQName, CData>)

Tuple Fields

0: EventMetrics

Number of bytes contributing to this event.

If this is the root element, this also includes any whitespace between the XML declaration and the start of the root element.

1: ResolvedQName

The namespace URI / localpart pair of the element.

2: HashMap<ResolvedQName, CData>

Attributes declared on the element, without XML namespace declarations.

The start of an XML element.

EndElement(EventMetrics)

Tuple Fields

0: EventMetrics

Number of bytes contributing to this event.

The number of bytes may be zero if this event is emitted in response to a /> in an element header, because the bytes for /> are accounted for in the corresponding Self::StartElement.

The end of an XML element.

The parser enforces that start/end pairs are correctly nested.

Text(EventMetrics, CData)

Tuple Fields

0: EventMetrics

Number of bytes contributing to this event.

Note that due to the expansion of character references and the processing of CDATA sections, the number of bytes consumed will generally be not equal to the number of bytes in emitted.

1: CData

Text content

References are expanded and CDATA sections processed correctly, so that the text in the event exactly corresponds to the logical character data.

Text CData.

This mirrors RawEvent::Text.

Note: Multiple consecutive Text events may be emitted for long sections of text or because of implementation details in the processing.

Implementations

impl ResolvedEvent

pub fn metrics(&self) -> &EventMetrics

Return the EventMetrics of the event

Trait Implementations

impl Clone for ResolvedEvent

fn clone(&self) -> ResolvedEvent

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ResolvedEvent

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

Formats the value using the given formatter.

impl PartialEq<ResolvedEvent> for ResolvedEvent

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

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

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

This method tests for !=.

impl Eq for ResolvedEvent

impl StructuralEq for ResolvedEvent

impl StructuralPartialEq for ResolvedEvent