Struct libflate::zlib::Encoder

pub struct Encoder<W, E = DefaultLz77Encoder> { /* fields omitted */ }

ZLIB encoder.

Methods

impl<W> Encoder<W, DefaultLz77Encoder> where
    W: Write, 

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

Makes a new encoder instance.

Encoded ZLIB stream is written to inner.

Examples

use std::io::Write;
use libflate::zlib::Encoder;

let mut encoder = Encoder::new(Vec::new()).unwrap();
encoder.write_all(b"Hello World!").unwrap();

assert_eq!(encoder.finish().into_result().unwrap(),
           vec![120, 156, 5, 192, 49, 13, 0, 0, 8, 3, 65, 43, 224, 6, 7, 24, 128,
                237, 147, 38, 245, 63, 244, 230, 65, 181, 50, 215, 1, 28, 73, 4, 62]);

impl<W, E> Encoder<W, E> where
    W: Write,
    E: Lz77Encode, 

pub fn with_options(inner: W, options: EncodeOptions<E>) -> Result<Self>

Makes a new encoder instance with specified options.

Encoded ZLIB stream is written to inner.

Examples

use std::io::Write;
use libflate::zlib::{Encoder, EncodeOptions};

let options = EncodeOptions::new().no_compression();
let mut encoder = Encoder::with_options(Vec::new(), options).unwrap();
encoder.write_all(b"Hello World!").unwrap();

assert_eq!(encoder.finish().into_result().unwrap(),
           [120, 1, 1, 12, 0, 243, 255, 72, 101, 108, 108, 111, 32, 87, 111,
            114, 108, 100, 33, 28, 73, 4, 62]);

pub fn header(&self) -> &Header

Returns the header of the ZLIB stream.

Examples

use libflate::zlib::{Encoder, Lz77WindowSize};

let encoder = Encoder::new(Vec::new()).unwrap();
assert_eq!(encoder.header().window_size(), Lz77WindowSize::KB32);

pub fn finish(self) -> Finish<W, Error>

Writes the ZLIB trailer and returns the inner stream.

Examples

use std::io::Write;
use libflate::zlib::Encoder;

let mut encoder = Encoder::new(Vec::new()).unwrap();
encoder.write_all(b"Hello World!").unwrap();

assert_eq!(encoder.finish().into_result().unwrap(),
           vec![120, 156, 5, 192, 49, 13, 0, 0, 8, 3, 65, 43, 224, 6, 7, 24, 128,
                237, 147, 38, 245, 63, 244, 230, 65, 181, 50, 215, 1, 28, 73, 4, 62]);

Note

If you are not concerned the result of this encoding, it may be convenient to use AutoFinishUnchecked instead of the explicit invocation of this method.

use std::io;
use libflate::finish::AutoFinishUnchecked;
use libflate::zlib::Encoder;

let plain = b"Hello World!";
let mut buf = Vec::new();
let mut encoder = AutoFinishUnchecked::new(Encoder::new(&mut buf).unwrap());
io::copy(&mut &plain[..], &mut encoder).unwrap();

pub fn as_inner_ref(&self) -> &W

Returns the immutable reference to the inner stream.

pub fn as_inner_mut(&mut self) -> &mut W

Returns the mutable reference to the inner stream.

pub fn into_inner(self) -> W

Unwraps the Encoder, returning the inner stream.

Trait Implementations

impl<W, E> Complete for Encoder<W, E> where
    W: Write,
    E: Lz77Encode, 

fn complete(self) -> Result<()>

Completes the current processing and returns the result.

impl<W: Debug, E: Debug> Debug for Encoder<W, E>

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl<W, E> Write for Encoder<W, E> where
    W: Write,
    E: Lz77Encode, 

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

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

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

Flush this output stream, ensuring that all intermediately buffered contents reach their destination.

fn write_vectored(&mut self, bufs: &[IoSlice]) -> Result<usize, Error>

Like write, except that it writes from a slice of buffers.

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

Attempts to write an entire buffer into this writer.

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.