Struct ebml_iterable::TagWriter

pub struct TagWriter<W: Write> { /* fields omitted */ }

Provides a tool to write EBML files based on Tags. Writes to a destination that implements std::io::Write.

Unlike the TagIterator, this does not require a specification to write data. The reason for this is that tags passed into this writer must provide the tag id, and these tags by necessity have their data in a format that can be encoded to binary. Because a specification is really only useful for providing context for tags based on the tag id, there is little value in using a specification during writing (other than ensuring that tag data matches the format described by the specification, which is not currently implemented.) The TagWriter can write any TagPosition objects regardless of whether they came from a TagIterator or not.

Example

use std::fs::File;
use ebml_iterable::TagWriter;
use ebml_iterable::tags::{TagPosition, TagData};

let mut file = File::create("my_ebml_file.ebml")?;
let mut my_writer = TagWriter::new(&mut file);
my_writer.write(TagPosition::FullTag(0x1a45dfa3, TagData::Master(Vec::new())))?;

Implementations

impl<W: Write> TagWriter<W>

pub fn new(dest: W) -> Self

pub fn write(&mut self, tag: TagPosition) -> Result<(), TagWriterError>