Struct xml::writer::EventWriter

pub struct EventWriter<W> { /* fields omitted */ }

A wrapper around an std::io::Write instance which emits XML document according to provided events.

Methods

impl<W: Write> EventWriter<W>

fn new(sink: W) -> EventWriter<W>

Creates a new EventWriter out of an std::io::Write instance using the default configuration.

fn new_with_config(sink: W, config: EmitterConfig) -> EventWriter<W>

Creates a new EventWriter out of an std::io::Write instance using the provided configuration.

fn write<'a, E>(&mut self, event: E) -> Result<()> where
    E: Into<XmlEvent<'a>>, 

Writes the next piece of XML document according to the provided event.

Note that output data may not exactly correspond to the written event because of various configuration options. For example, XmlEvent::EndElement may correspond to a separate closing element or it may cause writing an empty element. Another example is that XmlEvent::CData may be represented as characters in the output stream.

fn into_inner(self) -> W

Unwraps this EventWriter, returning the underlying writer.

Note that this is a destructive operation: unwrapping a writer and then wrapping it again with EventWriter::new() will create a fresh writer whose state will be blank; for example, accumulated namespaces will be reset.