Trait `Operation`

trait Operation

Represents an abstract compression/decompression operation.

This trait covers both Encoder and Decoder.

Required Methods

fn run<C: WriteBuf + ?Sized>(self: &mut Self, input: &mut InBuffer<'_>, output: &mut OutBuffer<'_, C>) -> Result<usize>

Performs a single step of this operation.

Should return a hint for the next input size.

If the result is Ok(0), it may indicate that a frame was just finished.

fn run_on_buffers(self: &mut Self, input: &[u8], output: &mut [u8]) -> Result<Status>

Performs a single step of this operation.

This is a comvenience wrapper around Operation::run if you don't want to deal with InBuffer/OutBuffer.

fn flush<C: WriteBuf + ?Sized>(self: &mut Self, output: &mut OutBuffer<'_, C>) -> Result<usize>

Flushes any internal buffer, if any.

Returns the number of bytes still in the buffer. To flush entirely, keep calling until it returns Ok(0).

fn reinit(self: &mut Self) -> Result<()>

Prepares the operation for a new frame.

This is hopefully cheaper than creating a new operation.

fn finish<C: WriteBuf + ?Sized>(self: &mut Self, output: &mut OutBuffer<'_, C>, finished_frame: bool) -> Result<usize>

Finishes the operation, writing any footer if necessary.

Returns the number of bytes still to write.

Keep calling this method until it returns Ok(0), and then don't ever call this method.