zlib.h摘要（二）
关于deflate函数和inflate函数
/*
ZEXTERN int ZEXPORT deflateInit OF((z_streamp strm, int level));
为压缩初始化内部流状态，zalloc，zfree和opaque字段必须在调用之前初始化，如果zalloc和zfree被
初始化为Z_NULL，deflateInit会更新它们而使用默认的分配函数。
压缩级别必须为Z_DEFAULT_COMPRESSION，或者0到9之间的数；1表示最快速度的压缩，9表示
最优压缩，0不做任何压缩，Z_DEFAULT_COMPRESSION是速度和最优压缩的折衷（一般为6）。
函数成功返回Z_OK，如果没有足够的内存则返回Z_MEM_ERROR，如果不是一个有效的压缩级别则
返回Z_STREAM_ERROR，版本不兼容则返回Z_VERSION_ERROR。如果没有错误信息则msg被设置为0。
deflateInit不会做任何压缩，这些都留给deflate()去做
*/
ZEXTERN int ZEXPORT deflate OF((z_streamp strm, int flush));
/*
deflate 函数尽可能的压缩数据，当输入缓冲为空或者输出缓冲满了的时候会停止。它会带来输出延迟（读输
入数据而没有输出）除非强行刷新缓冲区。
详细的语意如下，deflate会执行下面的一个或者两个动作都执行：
－从next_in开始压缩输入数据从而更新next_in和avail_in。如果不是所有输入数据可以被处理（因为输出缓
冲没有足够的空间），next_in和avail_in会更新，当再次调用deflate()函数时输入数据会从这一点开始被处理。
－从next_out开始提供更多输出数据从而更新next_out和avail_out，如果flush参数不是为0的化这个动作是
强制性的，经常性的强制刷新缓冲区会降低压缩比率，所以只有必要的时候才会设置这个参数（在交际程
序时），一些数据也会输出即使刷新没有被设置。
在调用deflate()函数之前，应用程序必须保证至少上面的一个动作被执行，用提供更多输入数据和/或消耗更多
输出数据的方式.，从而更新avail_in或avail_out；avail_out在函数调用之前千万不能为0。应用程序可以随时
消耗被压缩的输出数据，举个例子：当输出缓冲满了或者在每次调用deflate()之后，如果deflate返回Z_OK
并avail_out为0时，deflate()必须再次被调用。
一般刷新参数要设置为Z_NO_FLUSH，它允许deflate决定在产生输出时会积聚多少数据，为了使压缩最大化
如果flush参数被设置为Z_SYNC_FLUSH，所有的未处理的输出都会被传输到输出缓冲，缓冲区会按字节边界
排列，所以压缩器可以获得目前为止所有有效的数据。（特别的在调用函数后avail_in为0，如果在调用之前
有足够的输出空间）。由于一些压缩策略，刷新也许会退化压缩，所以只有必要的时候才会用。
如果刷新参数被设置为Z_FULL_FLUSH，所有输出会被刷新就像使用Z_SYNC_FLUSH一样，刷新状态会
复位，如此以致于如果之前的已压缩数据被毁坏或涉及了随机存取，解压可以重新开始。
如果deflate返回avail_out==0，这个函数必须再次被调用，刷新参数要相同，扩大输出空间（更新的
avail_out），直到完全刷新（deflate返回非0的avail_out）。在Z_FULL_FLUSH或Z_SYNC_FLUSH的
情况下，要确保avail_out要比6更大从而避免重复的刷新依赖于avail_out==0的返回值。
如果刷新参数设置为Z_FINISH，未处理的输入被处理完毕，未处理的输出被刷新并且deflate返回Z_STREAM_END
如果有足够的输出空间；如果deflate返回Z_OK，此函数必须再次被调用用Z_FINISH和更多的输出空间而不
用更多的输入数据，直到它返回Z_STREAM_END或一个error。在deflate返回Z_STREAM_END后，可以
执行的操作就只有deflateReset或deflateEnd。
如果所有压缩操作在一步完成，deflateInit之后Z_FINISH可以立即被使用。在这种情况下，avail_out
至少是deflateBound的返回值。如果deflate不返回Z_STREAM_END，它就得被再次调用。
deflate()把adler32设置为strm->adler来检查目前为止所有输入
如果deflate可以对输入数据类型（Z_BINARY或Z_TEXT）做一个好的猜测，它可能会更新strm->data_type。
不确信的是，这些数据被认为是二进制的，这些字段仅仅是些信息而不会影响压缩算法
如果做了一些改进（更多的输入或更多的输出产生）deflate()返回Z_OK，如果所有输入被消耗以及所有输出
都产生（仅仅在flush被设置为Z_FINISH时），返回Z_STREAM_END，如果流状态不一致（next_in或
next_out为NULL）返回Z_STREAM_ERROR，如果程序都不能进行（next_in或next_out为0）返回
Z_BUF_ERROR。注意Z_BUF_ERROR不是致命的，deflate可以被再次调用with更多的input和output空间
这样可以继续执行压缩。
*/
ZEXTERN int ZEXPORT deflateEnd OF((z_streamp strm));
/*为这个流分配的所有动态的数据结构都会被释放，这个函数丢弃了没有处理的输入数据而且不刷新未处理
的输出缓冲区。
deflateEnd返回Z_OK如果成功的话，如果流状态不一致则返回Z_STREAM_ERROR，如果流是过早的释放
则返回Z_DATA_ERROR（一些输入或输出被丢弃）。这种错误发生时，msg可能被设置但为静态字符串
（不会被释放）。
*/