variable_size_byte_writer

A Rust crate for writing variable-size bytes into io::Write traited targets.

Writes are internally buffered and so the usage of any additional buffering such as std::io::BufWriter is not recommended.

Note that VariableSizeByteWriter does not flush its internal buffer when dropped.

Usage:

Writing some unconventionally sized bytes into Vec

use variable_size_byte_writer::*;

let mut target = Vec::new();
let mut writer = VariableSizeByteWriter::new();
let bytes = [(0x3F, 6),(0x1AFF, 13),(0x7, 3)];

bytes
    .iter()
    .for_each(|&(byte, bits)|
        writer.write_16(&mut target, byte, bits).unwrap()
    );

let mut padding = 0;
writer
    .flush_all_bytes(&mut target, &mut padding)
    .unwrap();

assert_eq!(padding, 2);
assert_eq!(target[..], [0xFF, 0xBF, 0x3E]);

Writing a series of 7bit bytes into a file

use std::fs::File;
use variable_size_byte_writer::*;

let mut writer = VariableSizeByteWriter::new();
let mut file = File::create("path").unwrap();

for variable in 0..0x8F {
    writer.write_8(&mut file, variable, 7).unwrap();
}

let mut padding = 0;
writer
    .flush_all_bytes(&mut file, &mut padding)
    .unwrap();

License

variable_size_byte_writer is distributed under the terms of MIT licence.