Struct Encoder 

pub struct Encoder { /* private fields */ }

A streaming gzip encoder (one member).

Examples

use compress_lib::{Level, deflate::Flush, gzip};

let mut enc = gzip::Encoder::new(Level::DEFAULT);
let mut packed = Vec::new();
enc.compress_vec(b"part one, ", &mut packed, Flush::None)?;
enc.compress_vec(b"part two", &mut packed, Flush::Finish)?;
assert_eq!(gzip::decompress(&packed)?, b"part one, part two");

Implementations

impl Encoder

pub fn new(level: Level) -> Self

An encoder at level with the plain header of GzipHeader::new.

Examples

let enc = compress_lib::gzip::Encoder::new(compress_lib::Level::BEST);

pub fn with_header(self, header: GzipHeader) -> Self

Writes header instead of the plain one.

Examples

use compress_lib::{Level, gzip::{Encoder, GzipHeader}};

let enc = Encoder::new(Level::DEFAULT).with_header(GzipHeader::new().with_name(b"a.txt"));

pub fn with_window_bits(self, bits: u8) -> Result<Self, Error>

Sets the window to 2^bits bytes, 8 to 15.

Errors

ErrorKind::InvalidWindowBits outside 8 to 15.

Examples

let enc = compress_lib::gzip::Encoder::default().with_window_bits(12)?;

pub fn reset(&mut self)

Starts a new member, keeping allocations and the header.

Examples

let mut enc = compress_lib::gzip::Encoder::default();
enc.reset();

pub fn total_in(&self) -> u64

Uncompressed bytes taken.

Examples

use compress_lib::{deflate::Flush, gzip};

let mut enc = gzip::Encoder::default();
enc.compress_vec(b"abc", &mut Vec::new(), Flush::Finish)?;
assert_eq!(enc.total_in(), 3);

pub fn memory_in_use(&self) -> usize

Heap bytes held.

Examples

assert!(compress_lib::gzip::Encoder::default().memory_in_use() > 0);

pub fn compress( &mut self, input: &[u8], output: &mut [u8], flush: Flush, ) -> Result<Progress, Error>

As Deflater::compress, with the header written first and the CRC-32 and length after Finish.

Errors

As Deflater::compress.

Examples

use compress_lib::{deflate::{Flush, Status}, gzip};

let mut enc = gzip::Encoder::default();
let mut out = [0u8; 64];
let p = enc.compress(b"abc", &mut out, Flush::Finish)?;
assert_eq!(p.status, Status::Done);
assert_eq!(gzip::decompress(&out[..p.produced])?, b"abc");

pub fn compress_vec( &mut self, input: &[u8], out: &mut Vec<u8>, flush: Flush, ) -> Result<Progress, Error>

As compress, appending to out until the flush point is written.

Errors

As compress, plus AllocationFailed.

Examples

use compress_lib::{deflate::Flush, gzip};

let mut out = Vec::new();
gzip::Encoder::default().compress_vec(b"abc", &mut out, Flush::Finish)?;
assert_eq!(gzip::decompress(&out)?, b"abc");

Trait Implementations

impl Debug for Encoder

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

Formats the value using the given formatter.

impl Default for Encoder

fn default() -> Self

Returns the “default value” for a type.