Name

deflateReset — Resets all state associated with stream.

Library

Libz.lib

Synopsis

#include <zlib.h>

int deflateReset(z_streamp stream);

Return Value

On success, deflateReset() shall return Z_OK. Otherwise it shall return Z_STREAM_ERROR to indicate the error.

Detailed Description

The deflateReset() function shall reset all state associated with stream. All pending output shall be discarded, and the counts of processed bytes (total_in and total_out) shall be reset to zero.

Examples

To reset all the states associated with the stream:

#include <stdio.h>
#include <zlib.h>

void DeflateReset( )
{
    z_stream stream;
    int level = Z_DEFAULT_COMPRESSION ;
    uLong sourceLen = (uLong)strlen(hello)+1;
    Byte *compr, *uncompr;
    Bytef *dest = compr ;
    uLongf *destLen = &comprLen;
    const char hello[] = "hello, hello!";
    const Bytef *source = (const Bytef*)hello;
    uLong sourceLen = len;
    stream.next_in = (Bytef*)source;
    stream.avail_in = (uInt)sourceLen;
    uLong comprLen = 20*sizeof(int);
    uLong uncomprLen = comprLen;
    compr    = (Byte*)calloc((uInt)comprLen, 1);
    uncompr = (Byte*)calloc((uInt)uncomprLen, 1);

    stream.zalloc = (alloc_func)0;
    stream.zfree = (free_func)0;
    stream.opaque = (voidpf)0;

    deflateInit(&stream, level);
    deflateReset(&stream);
    deflateEnd(&stream);
    free(compr);
    free(uncompr);
}

Errors

On error, deflateReset() shall return Z_STREAM_ERROR. The following conditions shall be treated as an error:

The state in stream is inconsistent or inappropriate.
stream is NULL

Feedback

For additional information or queries on this page send feedback