zlib用法简单说明

天云上人

本文的目的是: 简单说明如何把zlib加入到MFC程序中,提供内存压缩功能.

1. 如何获得zlib
( i# i" S' K: J
0 N. n- \/ ]0 Q6 h% C) q" Fzlib的主页是:http://www.zlib.net/
+ k( g* d( Z+ ?1 k0 B) O
# [0 y3 m" O8 @( x  j$ r2. 用VC++6.0打开
  a7 S; O; y1 J5 a4 K4 V0 C) c7 h
把下载的源代码解压打开,VC6.0的工程已经建好了,在\projects\visualc6. 双击zlib.dsw, 可以在VC++6.0中看到里面有3个工程: zlib 是库文件(编译设置选中 win32 lib debug / release), 工程example 是如何使用 zlib.lib 的示例, 工程minigzip 是如何用 zlib 提供的函数读写.gz文件的示例(*.gz的文件一般Linux下比较常用).
6 {+ B8 p0 A) h( n& N! L: y: w0 ]+ O
, s: b+ Y. Y  S" {3. 如何加入到我的工程
4 ?$ x6 J+ _  m. B
编译好 zlib.lib 后, 你就得到了调用一个静态库所需要的所有文件了(zlib.lib, zlib.h, zconf.h). 如何调用静态库不用我说了吧.

4. 用zlib能干什么

, z+ j3 e# B, k先来看看 zlib 都提供了那些函数, 都在zlib.h中,看到一堆宏不要晕,其实都是为了兼容各种编译器和一些类型定义.死死抓住那些主要的函数的原型声明就不会受到这些东西的影响了.
6 V4 W) [* D0 ^% W
关键的函数有那么几个:
8 B4 p  J% ?( f" |. Q" u
7 |6 X% s9 R; z(1)int compress (Bytef *dest,   uLongf *destLen, const Bytef *source, uLong sourceLen);
& V( W4 i5 C7 |; b
把源缓冲压缩成目的缓冲, 就那么简单, 一个函数搞定

; u- i$ r- C3 B  o8 b(2) int compress2 (Bytef *dest,   uLongf *destLen,const Bytef *source, uLong sourceLen,int level);
5 u* X" `7 B) }% x
功能和上一个函数一样,都一个参数可以指定压缩质量和压缩数度之间的关系(0-9)不敢肯定这个参数的话不用太在意它,明白一个道理就好了: 要想得到高的压缩比就要多花时间

' P! s4 Y$ O( G! b6 H(3) uLong compressBound (uLong sourceLen);
- v/ x5 @# p& W& G& v! D5 b
计算需要的缓冲区长度. 假设你在压缩之前就想知道你的产度为 sourcelen 的数据压缩后有多大, 可调用这个函数计算一下,这个函数并不能得到精确的结果,但是它可以保证实际输出长度肯定小于它计算出来的长度

(4) int uncompress (Bytef *dest,   uLongf *destLen,const Bytef *source, uLong sourceLen);
) E3 l9 i3 Q1 B! C0 j. l
解压缩(看名字就知道了:)
+ }# W9 \1 W7 Z/ `" \$ n# b
(5) deflateInit() + deflate() + deflateEnd()
& [: K+ y  C5 ]4 ~8 I
+ n* k; L6 X" t5 H" p  W+ j3个函数结合使用完成压缩功能,具体用法看 example.c 的 test_deflate()函数. 其实 compress() 函数内部就是用这3个函数实现的(工程 zlib 的 compress.c 文件)

(6) inflateInit() + inflate() + inflateEnd()

; n* Q  L/ f+ M- n0 r和(5)类似,完成解压缩功能.
3 d0 M$ H) P! H! P3 o$ T
$ P7 N+ S4 f* ^, \* w' K, P(7) gz开头的函数. 用来操作*.gz的文件,和文件stdio调用方式类似. 想知道怎么用的话看example.c 的 test_gzio() 函数,很easy.

$ h; q) A( m5 T& Z* N# u8 p(8) 其他诸如获得版本等函数就不说了.
; b/ F  h8 H- O9 D. n总结: 其实只要有了compress() 和uncompress() 两个函数,在大多数应用中就足够了.

6 b) z3 d9 e/ l9 [: A题外话: 我最初看到zlib的源代码时被好多宏吓倒了,呵呵,后来仔细看下去才发现原来接口那么简单. 至于那些英文说明也没想象中的那么难懂.只要有尝试的勇气,总能有些收获.

. D6 z! k% {- e3 Q: I6 N本文来自CSDN博客，转载请标明出处：http://blog.csdn.net/querw/archive/2006/12/21/1452041.aspx
5 ~% V$ C8 u# R; \! L; I: C

天云上人

zlib 的安装

　　libpng 是一套免费的、公开源代码的程序库，支持对 PNG 图形文件的创建、读写等操作。libpng 使用 zlib 程序库作为压缩引擎，zlib 也是著名的 gzip (GNU zip) 所采用的压缩引擎。

　　我们首先安装zlib，从其官方网站下载最新的源程序，不妨假设文件名是zlib-1.1.4.tar.gz。网址：http://www.gzip.org/zlib/。

　　在 D:\ 建立 libpng 目录，将 zlib-1.1.4.tar.gz 释放到这个目录。尽管没有合适的makefile，我们仍然可以直接编译链接 zlib.lib：

1. D:\libpng\zlib-1.1.4>bcc32 -c -O2 -6 -w-8004 -w-8057 -w-8012 *.cBorland C++ 5.5.1 for Win32 Copyright (c) 1993, 2000 Borlandadler32.c:compress.c:crc32.c:deflate.c:example.c:gzio.c:infblock.c:infcodes.c:inffast.c:inflate.c:inftrees.c:infutil.c:maketree.c:minigzip.c:trees.c:uncompr.c:zutil.c: D:\libpng\zlib-1.1.4>tlib zlib.lib +adler32.obj +compress.obj +crc32.obj+deflate.obj +gzio.obj +infblock.obj +infcodes.obj
   + X9 b; s, F, V, w! N
2. +inffast.obj +inflate.obj +inftrees.obj +infutil.obj +maketree.obj
   4 Q5 u* h  R! U+ L
3. +trees.obj+uncompr.obj +zutil.obj
   
4. TLIB 4.5 Copyright (c) 1987, 1999 Inprise Corporation

复制代码

　　注意，在 tlib 的命令行中，没有 example.obj 和 minigzip.obj。接下来，测试 zlib.lib 是否编译成功，执行：

1. D:\libpng\zlib-1.1.4>bcc32 minigzip.obj zlib.libBorland C++ 5.5.1 for Win32 Copyright (c) 1993, 2000 BorlandTurbo Incremental Link 5.00 Copyright (c) 1997, 2000 Borland D:\libpng\zlib-1.1.4>bcc32 example.obj zlib.libBorland C++ 5.5.1 for Win32 Copyright (c) 1993, 2000 BorlandTurbo Incremental Link 5.00 Copyright (c) 1997, 2000 Borland D:\libpng\zlib-1.1.4>exampleuncompress(): hello, hello!gzread(): hello, hello!gzgets() after gzseek: hello!inflate(): hello, hello!large_inflate(): OKafter inflateSync(): hello, hello!inflate with dictionary: hello, hello!

复制代码

执行 example.exe，看见“hello, hello!”，表明生成的 zlib.lib 是好的。

　　zlib 是通用的压缩库，提供了一套 in-memory 压缩和解压函数，并能检测解压出来的数据的完整性(integrity)。zlib 也支持读写 gzip (.gz) 格式的文件。下面介绍两个最有用的函数——compress 和 uncompress。

1. int compress(Bytef *dest, uLongf *destLen, const Bytef *source, uLong sourceLen);

复制代码

　　compress函数将 source 缓冲区中的内容压缩到 dest 缓冲区。 sourceLen 表示source 缓冲区的大小(以字节计)。注意函数的第二个参数 destLen 是传址调用。当调用函数时，destLen表示 dest 缓冲区的大小，destLen > (sourceLen + 12)*100.1%。当函数退出后，destLen 表示压缩后缓冲区的实际大小。此时 destLen / sourceLen 正好是压缩率。

　　compress 若成功，则返回 Z_OK；若没有足够内存，则返回 Z_MEM_ERROR；若输出缓冲区不够大，则返回 Z_BUF_ERROR。

1. int uncompress(Bytef *dest, uLongf *destLen, const Bytef *source, uLong sourceLen);

复制代码

　　uncompress 函数将 source 缓冲区的内容解压缩到 dest 缓冲区。sourceLen 是 source 缓冲区的大小(以字节计)。注意函数的第二个参数 destLen 是传址调用。当调用函数时，destLen 表示 dest 缓冲区的大小， dest 缓冲区要足以容下解压后的数据。在进行解压缩时，需要提前知道被压缩的数据解压出来会有多大。这就要求在进行压缩之前，保存原始数据的大小(也就是解压后的数据的大小)。这不是 zlib 函数库的功能，需要我们做额外的工作。当函数退出后， destLen 是解压出来的数据的实际大小。

　　uncompress 若成功，则返回 Z_OK ；若没有足够内存，则返回 Z_MEM_ERROR；若输出缓冲区不够大，则返回 Z_BUF_ERROR。若输入数据有误，则返回 Z_DATA_ERROR。

　　zlib 带的 example.c 是个很好的学习范例，值得一观。我们写个程序，验证 zlib 的压缩功能。所写的测试程序保存为 testzlib.cpp ，放在 zlib-1.1.4 目录下。程序源代码：

1. // testzlib.cpp 简单测试 zlib 的压缩功能#include <cstring>#include <cstdlib>#include
   ) u$ q" F5 _. i5 y' c8 L$ x
2. <iostream>#include "zlib.h" using namespace
   
3. std; int main(){int err;Byte compr[200], uncompr[200];// big enoughuLong comprLen, uncomprLen;const char* hello = "12345678901234567890123456789012345678901234567890";uLong len = strlen(hello) + 1;comprLen = sizeof(compr) / sizeof(compr[0]);err = compress(compr, &comprLen, (const Bytef*)hello, len);if (err != Z_OK) {cerr << "compess error: " << err << '\n';exit(1);}cout << "orignal size: " << len << " , compressed size : " << comprLen << '\n';strcpy((char*)uncompr, "garbage");err = uncompress(uncompr, &uncomprLen, compr, comprLen);if (err != Z_OK) {cerr << "uncompess error: " << err << '\n';exit(1);}cout << "orignal size: " << len << " , uncompressed size : " << uncomprLen << '\n';if (strcmp((char*)uncompr, hello)) {cerr << "BAD uncompress!!!\n";exit(1);} else {cout << "uncompress() succeed: \n" << (char *)uncompr;}}

复制代码

编译执行这个程序，输出应该是

1. D:\libpng\zlib-1.1.4>bcc32 testzlib.cpp zlib.lib D:\libpng\zlib-1.1.4>testzliborignal size: 51 , compressed size : 22orignal size: 51 , uncompressed size : 51uncompress() succeed:12345678901234567890123456789012345678901234567890

复制代码

至此， zlib的安装任务算是完成了。为了以后使用方便，我将zlib.lib、zlib.h、zconf.h拷贝到D:\mylibs\。
% U/ ~4 K8 Z' ?$ R