Struct xml::reader::EventReader

pub struct EventReader<R: Read> { /* fields omitted */ }

A wrapper around an std::io::Read instance which provides pull-based XML parsing.

Methods

impl<R: Read> EventReader<R>

pub fn new(source: R) -> EventReader<R>

Creates a new reader, consuming the given stream.

pub fn new_with_config(source: R, config: ParserConfig) -> EventReader<R>

Creates a new reader with the provded configuration, consuming the given stream.

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

Pulls and returns next XML event from the stream.

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

pub fn source(&self) -> &R

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

pub fn into_inner(self) -> R

Unwraps this EventReader, returning the underlying reader.

Note that this operation is destructive; unwrapping the reader and wrapping it again with EventReader::new() will create a fresh reader which will attempt to parse an XML document from the beginning.

impl<'r> EventReader<&'r [u8]>

pub fn from_str(source: &'r str) -> EventReader<&'r [u8]>

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

Trait Implementations

impl<B: Read> Position for EventReader<B>

fn position(&self) -> TextPosition

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

impl<R: Read> IntoIterator for EventReader<R>

type Item = Result<XmlEvent>

The type of the elements being iterated over.

type IntoIter = Events<R>

Which kind of iterator are we turning this into?

Important traits for Events<R>

impl<R: Read> Iterator for Events<R> type Item = Result<XmlEvent>;

fn into_iter(self) -> Events<R>

Creates an iterator from a value.