Module quick_xml::events[][src]

Expand description

Defines zero-copy XML events used throughout this library.

A XML event often represents part of a XML element. They occur both during reading and writing and are usually used with the stream-oriented API.

For example, the XML element

<name attr="value">Inner text</name>

consists of the three events Start, Text and End. They can also represent other parts in an XML document like the XML declaration. Each Event usually contains further information, like the tag name, the attribute or the inner text.

See Event for a list of all possible events.

Reading

When reading a XML stream, the events are emitted by Reader::read_event. You must listen for the different types of events you are interested in.

See Reader for further information.

Writing

When writing the XML document, you must create the XML element by constructing the events it consists of and pass them to the writer sequentially.

See Writer for further information.

Modules

Xml Attributes module

Structs

An XML declaration (Event::Decl).

A struct to manage Event::End events

Opening tag data (Event::Start), with optional attributes.

Data from various events (most notably, Event::Text).

Enums

Event emitted by Reader::read_event.