Function miniz_oxide::inflate::core::decompress
source · pub fn decompress(
r: &mut DecompressorOxide,
in_buf: &[u8],
out: &mut [u8],
out_pos: usize,
flags: u32
) -> (TINFLStatus, usize, usize)
Expand description
Main decompression function. Keeps decompressing data from in_buf
until the in_buf
is
empty, out
is full, the end of the deflate stream is hit, or there is an error in the
deflate stream.
Arguments
r
is a DecompressorOxide
struct with the state of this stream.
in_buf
is a reference to the compressed data that is to be decompressed. The decompressor will
start at the first byte of this buffer.
out
is a reference to the buffer that will store the decompressed data, and that
stores previously decompressed data if any.
- The offset given by
out_pos
indicates where in the output buffer slice writing should start. - If
TINFL_FLAG_USING_NON_WRAPPING_OUTPUT_BUF
is not set, the output buffer is used in a wrapping manner, and it’s size is required to be a power of 2. - The decompression function normally needs access to 32KiB of the previously decompressed data
(or to the beginning of the decompressed data if less than 32KiB has been decompressed.)
- If this data is not available, decompression may fail.
- Some deflate compressors allow specifying a window size which limits match distances to less than this, or alternatively an RLE mode where matches will only refer to the previous byte and thus allows a smaller output buffer. The window size can be specified in the zlib header structure, however, the header data should not be relied on to be correct.
flags
indicates settings and status to the decompression function.
- The
TINFL_FLAG_HAS_MORE_INPUT
has to be specified if more compressed data is to be provided in a subsequent call to this function. - See the the
inflate_flags
module for details on other flags.
Returns
Returns a tuple containing the status of the compressor, the number of input bytes read, and the
number of bytes output to out
.
This function shouldn’t panic pending any bugs.