zip.h解析

// 返回值
#define ZIP_OK                          (0)
#define ZIP_EOF                         (0)
#define ZIP_ERRNO                       (Z_ERRNO)
#define ZIP_PARAMERROR                  (-102)
#define ZIP_BADZIPFILE                  (-103)
#define ZIP_INTERNALERROR               (-104)

// 压缩等级
#ifndef DEF_MEM_LEVEL
#  if MAX_MEM_LEVEL >= 8
#    define DEF_MEM_LEVEL 8
#  else
#    define DEF_MEM_LEVEL  MAX_MEM_LEVEL
#  endif
#endif

// zip文件修改/保存时间的结构体tm_zip
// 注意月的取值范围是[0-11]
typedef struct tm_zip_s
{
	uInt tm_sec;            // 秒
	uInt tm_min;            // 分
	uInt tm_hour;           // 时
	uInt tm_mday;           // 天
	uInt tm_mon;            // 月
	uInt tm_year;           // 年，范围[1980,2044]
} tm_zip;

// zip的信息结构体zip_fileinfo
typedef struct
{
	tm_zip      tmz_date;       // 文件的上次修改/保存时间
	uLong       dosDate;        // dos格式时间。设为0即可
	uLong       internal_fa;    // 内部文件属性
	uLong       external_fa;    // 外部文件属性
} zip_fileinfo;

typedef const char* zipcharpc;


#define APPEND_STATUS_CREATE        (0)	//创建新文件
#define APPEND_STATUS_CREATEAFTER   (1) 	//在已有zip文件后追加(无视密码？)
#define APPEND_STATUS_ADDINZIP      (2) 	//在已有zip文件中添加
// 不存在从zip中删除子文件的操作。若有此需求，需要创建新的zip

// 创建/打开一个zip文件。执行压缩操作必须首先调用此函数
extern zipFile ZEXPORT zipOpen OF((const char *pathname, int append));


// 创建/打开zip文件中的一个子文件，将其设为当前文件，以用于后续的写入操作。
extern int ZEXPORT zipOpenNewFileInZip OF((
	zipFile file,					// zip文件
	const char* filename, 			// zip中需要写入的子文件的文件名
	const zip_fileinfo* zipfi,		// 传入一些包括日期在内的zip补充信息
	const void* extrafield_local,		// 本子文件扩展信息
	uInt size_extrafield_local,		// 本子文件扩展信息大小
	const void* extrafield_global, 	// 全局文件扩展信息
	uInt size_extrafield_global, 		// 全局文件扩展信息大小
	const char* comment,				// 注释			
	int method,						// 压缩方式：0-store，ZDEFLATED-deflate
	int level						// 压缩等级：[0,9]。详见下面说明
	));

// 压缩等级
#define Z_NO_COMPRESSION         0
#define Z_BEST_SPEED             1
#define Z_BEST_COMPRESSION       9
#define Z_DEFAULT_COMPRESSION  (-1)	// 默认取值


// 向打开的当前文件中写入数据
extern int ZEXPORT zipWriteInFileInZip OF((zipFile file,
	const void* buf,
	unsigned len));

// 关闭打开的当前文件
extern int ZEXPORT zipCloseFileInZip OF((zipFile file));

extern int ZEXPORT zipCloseFileInZipRaw OF((zipFile file,
	uLong uncompressed_size,
	uLong crc32));
/*
Close the current file in the zipfile, for file opened with
parameter raw=1 in zipOpenNewFileInZip2
uncompressed_size and crc32 are value for the uncompressed size
*/

// 关闭zip文件。压缩完成
extern int ZEXPORT zipClose OF((zipFile file,
	const char* global_comment));