Struct deflate::write::ZlibEncoder

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

A Zlib encoder/compressor.

A struct implementing a Write interface that takes unencoded data and compresses it to the provided writer using DEFLATE compression with Zlib headers and trailers.

Examples

use std::io::Write;

use deflate::Compression;
use deflate::write::ZlibEncoder;

let data = b"This is some test data";
let mut encoder = ZlibEncoder::new(Vec::new(), Compression::Default);
encoder.write_all(data)?;
let compressed_data = encoder.finish()?;

Methods

impl<W: Write> ZlibEncoder<W>

fn new<O: Into<CompressionOptions>>(writer: W, options: O) -> ZlibEncoder<W>

Create a new ZlibEncoder using the provided compression options.

fn finish(self) -> Result<W>

Encode all pending data to the contained writer, consume this ZlibEncoder, and return the contained writer if writing succeeds.

fn reset(&mut self, writer: W) -> Result<W>

Resets the encoder (except the compression options), replacing the current writer with a new one, returning the old one.

fn checksum(&self) -> u32

Return the adler32 checksum of the currently consumed data.

Trait Implementations

impl<W: Write> Write for ZlibEncoder<W>

fn write(&mut self, buf: &[u8]) -> Result<usize>

Write a buffer into this object, returning how many bytes were written.

fn flush(&mut self) -> Result<()>

Flush the encoder.

This will flush the encoder, emulating the Sync flush method from Zlib. This essentially finishes the current block, and sends an additional empty stored block to the writer.

fn write_all(&mut self, buf: &[u8]) -> Result<(), Error>

Attempts to write an entire buffer into this write.

fn write_fmt(&mut self, fmt: Arguments) -> Result<(), Error>

Writes a formatted string into this writer, returning any error encountered.

fn by_ref(&mut self) -> &mut Self

Creates a "by reference" adaptor for this instance of Write.

impl<W: Write> Drop for ZlibEncoder<W>

fn drop(&mut self)

When the encoder is dropped, output the rest of the data.

WARNING: This may silently fail if writing fails, so using this to finish encoding for writers where writing might fail is not recommended, for that call finish() instead.