Struct EventReader

pub struct EventReader<'a, S: Iterator<Item = &'a u8>> { /* private fields */ }

A wrapper around an Iterator which provides pull-based XML parsing.

Implementations

impl<'a, S: Iterator<Item = &'a u8>> EventReader<'a, S>

pub fn new(source: S) -> EventReader<'a, S>

Creates a new reader from an Iterator.

pub fn new_with_config( source: S, config: impl Into<ParserConfig2>, ) -> EventReader<'a, S>

Creates a new reader with the provided configuration from an Iterator.

pub fn next(&mut self) -> Result<XmlEvent>

Pulls and returns next XML event from the Iterator.

If returned event is XmlEvent::Error or XmlEvent::EndDocument, then further calls to this method will return this event again.

pub fn skip(&mut self) -> Result<()>

Skips all XML events until the next end tag at the current level.

Convenience function that is useful for the case where you have encountered a start tag that is of no interest and want to skip the entire XML subtree until the corresponding end tag.

pub fn source(&self) -> &S

pub fn source_mut(&mut self) -> &mut S

pub fn into_inner(self) -> S

Unwraps this EventReader, returning the underlying Iterator.

impl<'a> EventReader<'a, Iter<'a, u8>>

pub fn from_str(source: &str) -> EventReader<'_, Iter<'_, u8>>

A convenience method to create an XmlReader from a string slice.

Trait Implementations

impl<'a, S: Iterator<Item = &'a u8>> IntoIterator for EventReader<'a, S>

type Item = Result<XmlEvent, Error>

The type of the elements being iterated over.

type IntoIter = Events<'a, S>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Events<'a, S>

Creates an iterator from a value.

impl<'a, S: Iterator<Item = &'a u8>> Position for EventReader<'a, S>

fn position(&self) -> TextPosition

Returns the position of the last event produced by the reader.