Struct flate2::Compress

pub struct Compress {
    // some fields omitted
}

Raw in-memory compression stream for blocks of data.

This type is the building block for the I/O streams in the rest of this crate. It requires more management than the Read/Write API but is maximally flexible in terms of accepting input from any source and being able to produce output to any memory location.

It is recommended to use the I/O stream adaptors over this type as they're easier to use.

Methods

impl Compress

fn new(level: Compression, zlib_header: bool) -> Compress

Creates a new object ready for compressing data that it's given.

The level argument here indicates what level of compression is going to be performed, and the zlib_header argument indicates whether the output data should have a zlib header or not.

fn total_in(&self) -> u64

Returns the total number of input bytes which have been processed by this compression object.

fn total_out(&self) -> u64

Returns the total number of output bytes which have been produced by this compression object.

fn reset(&mut self)

Quickly resets this compressor without having to reallocate anything.

This is equivalent to dropping this object and then creating a new one.

fn compress(&mut self, input: &[u8], output: &mut [u8], flush: Flush) -> Status

Compresses the input data into the output, consuming only as much input as needed and writing as much output as possible.

The flush option can be any of the available flushing parameters.

To learn how much data was consumed or how much output was produced, use the total_in and total_out functions before/after this is called.

fn compress_vec(&mut self, input: &[u8], output: &mut Vec<u8>, flush: Flush) -> Status

Compresses the input data into the extra space of the output, consuming only as much input as needed and writing as much output as possible.

This function has the same semantics as compress, except that the length of vec is managed by this function. This will not reallocate the vector provided or attempt to grow it, so space for the output must be reserved in the output vector by the caller before calling this function.