Struct AbxWriter 

pub struct AbxWriter<W: Write> { /* private fields */ }

Encodes Events as ABX to any Write sink.

Tag and attribute names are interned, attribute values are not. Events are written as given: the writer does not check that tags are balanced. Writes are small and frequent, so wrap files and sockets in a BufWriter.

Examples

use android_abx::{AbxParser, AbxWriter, Attribute, AttributeValue, Event};

let mut writer = AbxWriter::new(Vec::new())?;
writer.write_event(&Event::StartDocument)?;
writer.write_event(&Event::StartTag {
    name: "pkg".into(),
    attributes: vec![Attribute {
        name: "version".into(),
        value: AttributeValue::Int(3),
    }],
})?;
writer.write_event(&Event::EndTag { name: "pkg".into() })?;
writer.write_event(&Event::EndDocument)?;
let data = writer.into_inner();

let xml = AbxParser::new(&data)?.to_xml()?;
assert!(xml.ends_with(r#"<pkg version="3"></pkg>"#));

Implementations

impl<W: Write> AbxWriter<W>

pub fn new(writer: W) -> Result<Self>

Creates a writer and writes the header.

Errors

Returns AbxError::Io if writing fails.

pub fn write_event(&mut self, ev: &Event) -> Result<()>

Encodes and writes one event.

Errors

Returns AbxError::ValueTooLong if a string or byte value is longer than 65,535 bytes, or AbxError::Io if writing fails. After an error, the output is incomplete and should be discarded.

pub fn into_inner(self) -> W

Returns the underlying writer, without flushing it.