Struct quick_xml::Writer [−][src]
pub struct Writer<W: Write> { /* fields omitted */ }
XML writer.
Writes XML Event
s to a Write
implementor.
Examples
use failure::Fail; use quick_xml::{Reader, Writer}; use quick_xml::events::{Event, BytesEnd, BytesStart}; use std::io::Cursor; let xml = r#"<this_tag k1="v1" k2="v2"><child>text</child></this_tag>"#; let mut reader = Reader::from_str(xml); reader.trim_text(true); let mut writer = Writer::new(Cursor::new(Vec::new())); let mut buf = Vec::new(); loop { match reader.read_event(&mut buf) { Ok(Event::Start(ref e)) if e.name() == b"this_tag" => { // crates a new element ... alternatively we could reuse `e` by calling // `e.into_owned()` let mut elem = BytesStart::owned(b"my_elem".to_vec(), "my_elem".len()); // collect existing attributes elem.extend_attributes(e.attributes().map(|attr| attr.unwrap())); // copy existing attributes, adds a new my-key="some value" attribute elem.push_attribute(("my-key", "some value")); // writes the event to the writer assert!(writer.write_event(Event::Start(elem)).is_ok()); }, Ok(Event::End(ref e)) if e.name() == b"this_tag" => { assert!(writer.write_event(Event::End(BytesEnd::borrowed(b"my_elem"))).is_ok()); }, Ok(Event::Eof) => break, // we can either move or borrow the event to write, depending on your use-case Ok(e) => assert!(writer.write_event(&e).is_ok()), // errors are chained, the last one usually being the // position where the error has happened Err(e) => panic!("{:?}", e.causes().map(|e| format!("{:?} -", e)).collect::<String>()), } buf.clear(); } let result = writer.into_inner().into_inner(); let expected = r#"<my_elem k1="v1" k2="v2" my-key="some value"><child>text</child></my_elem>"#; assert_eq!(result, expected.as_bytes());
Methods
impl<W: Write> Writer<W>
[src]
impl<W: Write> Writer<W>
pub fn new(inner: W) -> Writer<W>
[src]
pub fn new(inner: W) -> Writer<W>
Creates a Writer from a generic Write
pub fn new_with_indent(
inner: W,
indent_char: u8,
indent_size: usize
) -> Writer<W>
[src]
pub fn new_with_indent(
inner: W,
indent_char: u8,
indent_size: usize
) -> Writer<W>
Creates a Writer with configured whitespace indents from a generic Write
pub fn into_inner(self) -> W
[src]
pub fn into_inner(self) -> W
Consumes this Writer
, returning the underlying writer.
pub fn write_event<'a, E: AsRef<Event<'a>>>(
&mut self,
event: E
) -> Result<usize>
[src]
pub fn write_event<'a, E: AsRef<Event<'a>>>(
&mut self,
event: E
) -> Result<usize>
Writes the given event to the underlying writer.
pub fn write(&mut self, value: &[u8]) -> Result<usize>
[src]
pub fn write(&mut self, value: &[u8]) -> Result<usize>
Writes bytes