Original Translation
18307
A string which contains any bytes past the end of the compressed data. That is, this remains ``""`` until the last byte that contains compression data is available. If the whole string turned out to contain compressed data, this is ``""``, the empty string.
18308
The only way to determine where a string of compressed data ends is by actually decompressing it. This means that when compressed data is contained part of a larger file, you can only find the end of it by reading data and feeding it followed by some non-empty string into a decompression object's :meth:`decompress` method until the :attr:`unused_data` attribute is no longer the empty string.
18309
A string that contains any data that was not consumed by the last :meth:`decompress` call because it exceeded the limit for the uncompressed data buffer. This data has not yet been seen by the zlib machinery, so you must feed it (possibly with further data concatenated to it) back to a subsequent :meth:`decompress` method call in order to get correct output.
18310
Decompress *string*, returning a string containing the uncompressed data corresponding to at least part of the data in *string*. This data should be concatenated to the output produced by any preceding calls to the :meth:`decompress` method. Some of the input data may be preserved in internal buffers for later processing.
18311
If the optional parameter *max_length* is supplied then the return value will be no longer than *max_length*. This may mean that not all of the compressed input can be processed; and unconsumed data will be stored in the attribute :attr:`unconsumed_tail`. This string must be passed to a subsequent call to :meth:`decompress` if decompression is to continue. If *max_length* is not supplied then the whole input is decompressed, and :attr:`unconsumed_tail` is an empty string.
18312
All pending input is processed, and a string containing the remaining uncompressed output is returned. After calling :meth:`flush`, the :meth:`decompress` method cannot be called again; the only realistic action is to delete the object.
18313
The optional parameter *length* sets the initial size of the output buffer.
18314
Returns a copy of the decompression object. This can be used to save the state of the decompressor midway through the data stream in order to speed up random seeks into the stream at a future point.
18315
Reading and writing :program:`gzip`\ -format files.
18316
The zlib library home page.
18317
The zlib manual explains the semantics and usage of the library's many functions.