Click here to Skip to main content
15,860,859 members
Articles / Desktop Programming / MFC

Zip Utils - Clean, Elegant, Simple, C++/Win32

Rate me:
Please Sign up or sign in to vote.
4.90/5 (237 votes)
19 Sep 2012Public Domain8 min read 4.3M   44.6K   437   638
Adding zip/unzip easily, no LIBS or DLLs, with an elegant and powerful API

zipping and unzipping in action!

Introduction

WARNING: This code has known bugs. It doesn't deal with non-ASCII filenames correctly. It doesn't deal with passwords correctly. I don't have time to fix it, unfortunately. But I've marked it so that other gold members can edit it, in case anyone wants to make the fix.

 

This source code shows how to add zip/unzip functionality to your programs. Lots of people have written their own wrappers around Zip, and indeed there are several articles on CodeProject that are based on earlier versions of my own code. How is this version different?

  • Clean packaging. There's one pair of files zip.cpp, zip.h to add to your project if you want zip. Another pair unzip.cpp, unzip.h if you want unzip (or both if you want both!). There are no additional libraries or DLLs to worry about.
  • Clean API. Most other APIs around zip/unzip are terrible. This one is the best. The API is short, clean, and in a familiar Win32 style. Most other APIs wrap things up in classes, which is ugly overkill for such a small problem and always turn out to be too inflexible. Mine doesn't. See the code snippets below.
  • Flexibility. With this code, you can unzip from a zip that's in a disk file, memory-buffer, pipe. You can unzip into a disk file, memory-buffer or pipe. The same for creating Zip files. This means that at last you don't need to write out your files to a temporary directory before using them! One noteworthy feature is that you can unzip directly from an embedded resource into a memory buffer or onto a disk file, which is great for installers. Another is the ability to create your Zip in dynamically growable memory backed by the system page file. Despite all this power, the API remains clean and simple. The power didn't come from just writing wrappers around other people's code. It came from restructuring the internals of zlib and info-zip source code. My code is unique in what it does here.
  • Encryption. This version supports password-based Zip encryption. Passwords are absent from many other Zip libraries, including gzip.
  • Unicode. This version supports Unicode filenames.
  • Windows CE. This version works as it is under Windows CE. No need to alter makefiles or #defines, or worry about compatibility of any LIB/DLL.
  • Bug fixes. This code is based on gzip 1.1.4, which fixes a security vulnerability in 1.1.3. (An earlier version of my code used 1.1.3, and has crept into other CodeProject articles...).

At its core, my code uses zlib and info-zip. See the end of the article for acknowledgements & license.

Using the Code

To add zip functionality to your code, add the file zip.cpp to your project, and #include "zip.h" to your source code.

Similarly for unzipping, add the file unzip.cpp to the project and #include "unzip.h" to your source code. Zip and unzip can co-exist happily in a single application. Or you can omit one or the other if you're trying to save space.

The following code snippets show how to use zip/unzip. They are taken from one of the demo applications included in the download. It also has project files for Visual Studio .NET and Borland C++ Builder6 and Embedded Visual C++ 3. The code snippets here use ASCII. But the functions all take arguments of type TCHAR* rather than char*, so you can use it fine under Unicode.

Example 1 - Create a Zip File from Existing Files

C#
// We place the file "simple.bmp" inside, but inside
// the zipfile it will actually be called "znsimple.bmp".
// Similarly the textfile.

HZIP hz = CreateZip("simple1.zip",0);
ZipAdd(hz,"znsimple.bmp",  "simple.bmp");
ZipAdd(hz,"znsimple.txt",  "simple.txt");
CloseZip(hz);

Example 2 - Unzip a Zip File Using the Names It Has Inside It

C#
HZIP hz = OpenZip("\\simple1.zip",0);
ZIPENTRY ze; GetZipItem(hz,-1,&ze); int numitems=ze.index;
// -1 gives overall information about the zipfile
for (int zi=0; zi<numitems; zi++)
{ ZIPENTRY ze; GetZipItem(hz,zi,&ze); // fetch individual details
  UnzipItem(hz, zi, ze.name);         // e.g. the item's name.
}
CloseZip(hz);

Example 3- Unzip from Resource Directly into Memory

This technique is useful for small games, where you want to keep all resources bundled up inside the executable, but restricting the size.

Suppose we used a .rc with 1 RCDATA "file.zip" to embed the zip file as a resource.

C#
HRSRC hrsrc = FindResource(hInstance,MAKEINTRESOURCE(1),RT_RCDATA);
HANDLE hglob = LoadResource(hInstance,hrsrc);
void *zipbuf = LockResource(hglob);
unsigned int ziplen = SizeofResource(hInstance,hrsrc);
hz = OpenZip(zipbuf, ziplen, 0);
ZIPENTRY ze; int i; FindZipItem(hz,"sample.jpg",true,&i,&ze);
// that lets us search for an item by filename.
// Now we unzip it to a membuffer.
char *ibuf = new char[ze.unc_size];
UnzipItem(hz,i, ibuf, ze.unc_size);
...
delete[] ibuf;
CloseZip(hz);
// note: no need to free resources obtained through Find/Load/LockResource

Example 4 - Unzip Chunk by Chunk to a membuffer

Normally when you call UnzipItem(...), it gives the return-code ZR_OK. But if you gave it too small a buffer so that it couldn't fit it all in, then it returns ZR_MORE.

C#
char buf[1024]; ZRESULT zr=ZR_MORE; unsigned long totsize=0;
while (zr==ZR_MORE)
{ zr = UnzipItem(hz,i, buf,1024);
  unsigned long bufsize=1024; if (zr==ZR_OK) bufsize=ze.unc_size-totsize;
  ... maybe write the buffer to a disk file here
  totsize+=bufsize;
}

Common Questions

STRICT? I think you should always compile with STRICT (in project-settings/preprocessor/defines), and full warnings turned on. Without STRICT, the HZIP handle becomes interchangeable with all other handles.

How to show a progress dialog? One of the included examples, "progress", shows how to do this.

How to add/remove files from an existing Zip file? The zip_utils currently only allows you to OpenZip() for unzipping, or CreateZip() for adding, but don't allow you to mix the two. To modify an existing zip (e.g.: adding or removing a file), you need to create a new zip and copy all the existing items from the old into the new. One of the included examples, "modify", shows how to do this. It defines two functions:

C#
ZRESULT RemoveFileFromZip(const TCHAR *zip, const TCHAR *name);
ZRESULT AddFileToZip(const TCHAR *zip, const TCHAR *name, const TCHAR *fn);
// eg. AddFileToZip("c:\\archive.zip","znsimple.txt","c:\\docs\\file.txt");
// If the zipfile already contained that thing (case-insensitive), it is removed.
// These two functions are defined in "modify.cpp"

"fatal error C1010: unexpected end of file while looking for precompiled header directive". To fix this, select zip.cpp and unzip.cpp and change Project > Settings > C++ > PrecompiledHeaders to NotUsingPrecompiledHeaders.

Discussion

Efrat says: "I think the design is very bad", and so objects when I say that my API is clean and others are not. (Actually, he says my documentation is the most conceited he's seen and my design is the worst that he's seen!) I've reproduced his comments here, with my responses, so you can make a more informed decision whether to use my library.

  • [Efrat] Better instead to use the boost IOStream library.

    [Response] I love the boost library. If people can figure out how to add it to their projects and zip/unzip with it, they should definitely use boost rather than my code. (I'm still trying to figure it out, though, and couldn't get it to compile under CE.)

  • [Efrat] A compressed archive has internal state; it's a classic object; the author's criticisms of OOP are unjustified. "OOP doesn't mean placing your code in a CPP file."

    [Response] I'm trying not to be OOP.

    1. You'll never inherit from an archive, nor invoke virtual methods from it: we only use encapsulation, not any of the other pillars of OOP. By using an opaque handle HZIP rather than a class, I indicate this clearly to the programmer. Also,
    2. C++ classes don't work cleanly across DLLs. Handles like HZIPs do.
  • [Efrat] For instance, progress-notifications should be done by virtual functions in a derived class, not by callbacks.

    [Response] To get progress, you invoke UnzipItem in a while loop, and each iteration unzips a little bit more of the file. This is clean, re-entrant, and has a simple API. I think this is an easier API than inheriting from a class. I think inheritance from library classes is bad, in general.

  • [Efrat] Compression should go in a DLL.

    [Response] I disagree. DLLs are always pain, for developers as well as users. Unzip only adds 40K in any case.

  • [Efrat] The API doesn't use the type system to differentiate between an HZIP for zipping and an HZIP for unzipping.

    [Response] This was intentional. The difference between zipping and unzipping is a current implementation drawback. I think an API should be clean, "inspirational", and you shouldn't encode current implementation limitations into the type system.

  • [Efrat] The API uses error-codes, rather than exceptions, but anyone who has graduated Programming 101 knows exceptions are better.

    [Response] I think exceptions are not welcomed anywhere nearly as widely as Efrat suggests. Also, they don't work cleanly across DLL boundaries, and they don't work on Pocket PC.

  • [Efrat] The API is inflexible; it should be coded for change, not just coded for all the options that were conceived while designing (handles, files, memory). Most users will think of sources and targets which this design can't support.

    [Response] The original Zip uses FILE*s, which are effectively the same as Windows pipes. I also provided memory-buffers which add an enormous amount of flexibility that's easy to use and requires no additional programming. For any user who needs sources and targets which can't be reached via a memory buffer, they shouldn't use these zip_utils.

  • [Efrat] The is unnecessarily Windows-specific. The original zlib works great and is portable; zip_utils offers no advantages. Compression is memory-manipulation and IO and so should not be platform-specific.

    [Response] In the olden days before STL, "cross-platform" code inevitably meant:

    1. peppered with so many #ifdefs that you couldn't read it,
    2. didn't work straight away under Windows.

    I started from an old code-base, and so Efrat's proposed bottom-up rewrite was not possible. The advantage this code offers over zlib is that it's just a single file to add to your project, it works first time under Windows, you can add it easily as a CPP module to your project (not just dll/lib), and the API is simpler.

In general, Efrat wants code to be a clean extensible framework. I don't; I want small compact code that works fine as it is. Furthermore, I think that "framework-isation" is the biggest source of bugs and code overruns in the industry.

Acknowledgements

This version of article was updated on 28th July, 2005. Many thanks to the readers at CodeProject who found bugs and contributed fixes to an earlier version. There was one terrible bug where, after a large file had been unzipped, the next one might not work. Alvin77 spotted this bug.

My work is a repackaged form of extracts from the zlib code available at www.gzip.org by Jean-Loup Gailly and Mark Adler and others. Also from the info-zip source code at www.info-zip.org. Plus a bunch of my own changes. The original source code can be found at the two mentioned websites. Also the original copyright notices and licenses can be found there, and also inside the files zip.cpp and unzip.cpp of my code. As for licensing of my own contributions, I place them into the public domain.

License

This article, along with any associated source code and files, is licensed under A Public Domain dedication


Written By
Technical Lead
United States United States
Lucian studied theoretical computer science in Cambridge and Bologna, and then moved into the computer industry. Since 2004 he's been paid to do what he loves -- designing and implementing programming languages! The articles he writes on CodeProject are entirely his own personal hobby work, and do not represent the position or guidance of the company he works for. (He's on the VB/C# language team at Microsoft).

Comments and Discussions

 
QuestionFailed to unzip a big file about 3 GB Pin
j.hyundo5-Dec-23 13:27
j.hyundo5-Dec-23 13:27 
Questionis it possible to extract the zip split file? Pin
Member 1144324519-Sep-21 23:27
Member 1144324519-Sep-21 23:27 
Questiondecompress the resource compressed file to the specified folder Pin
Member 1517406827-Apr-21 21:06
Member 1517406827-Apr-21 21:06 
QuestionZip Util Pin
Member 149573556-Jan-21 20:39
Member 149573556-Jan-21 20:39 
QuestionThis software is being sold for $49.95? Pin
Jeroen De Maeijer9-Dec-20 0:01
professionalJeroen De Maeijer9-Dec-20 0:01 
QuestionHow to change Unzip Folder with Zip Utils Pin
Member 1459912525-Mar-20 3:37
Member 1459912525-Mar-20 3:37 
AnswerRe: How to change Unzip Folder with Zip Utils Pin
Jeroen De Maeijer9-Dec-20 0:07
professionalJeroen De Maeijer9-Dec-20 0:07 
BugAmbiguity Error with namespace std Pin
Member 1477334315-Mar-20 4:27
Member 1477334315-Mar-20 4:27 
QuestionUNICode special characters Pin
uhk3-Mar-20 14:17
uhk3-Mar-20 14:17 
Questionthanks! Pin
Member 1436367726-Jun-19 1:43
Member 1436367726-Jun-19 1:43 
Questionerror in modify.cpp Pin
ajka4549-Nov-17 0:28
professionalajka4549-Nov-17 0:28 
PraiseThank you for a great contribution Pin
Aaron Balint17-Sep-17 13:03
Aaron Balint17-Sep-17 13:03 
QuestionCreateZip memory ZipAdd bug Pin
mengzhisuoliu21-Jun-17 22:06
mengzhisuoliu21-Jun-17 22:06 
QuestionCreateZip memory size is not enough! Pin
mengzhisuoliu21-Jun-17 21:02
mengzhisuoliu21-Jun-17 21:02 
QuestionSimple example of creating ZIP archive in memory Pin
Member 129423649-Jan-17 19:35
Member 129423649-Jan-17 19:35 
SuggestionTwo fixes in zip.cpp Pin
Marek Macho12-Oct-16 2:29
Marek Macho12-Oct-16 2:29 
GeneralRe: Two fixes in zip.cpp Pin
gcy1119-Mar-17 19:25
gcy1119-Mar-17 19:25 
SuggestionTwo fixes in unzip.cpp - int unzOpenCurrentFile Pin
Marek Macho12-Oct-16 2:21
Marek Macho12-Oct-16 2:21 
Questionexample.cpp is not exits Pin
Member 1278848611-Oct-16 17:35
Member 1278848611-Oct-16 17:35 
Questionunresolved external symbol __imp__GetDesktopWindow@0 Pin
Member 1267261230-Aug-16 21:37
Member 1267261230-Aug-16 21:37 
PraiseThanks for this. It is very easy to use. Pin
Member 988645924-Aug-16 9:03
Member 988645924-Aug-16 9:03 
Questioncompression level Pin
bobsel10-Aug-16 3:25
bobsel10-Aug-16 3:25 
QuestionYou can't remove file from zip when file is with password Pin
Brackets9-Aug-16 3:34
Brackets9-Aug-16 3:34 
QuestionZip from memory Lenght Size limit? Pin
Giordano Settimo29-Jan-16 2:40
Giordano Settimo29-Jan-16 2:40 
QuestionCompilation mistakes. Pin
Member 1214830417-Nov-15 18:55
Member 1214830417-Nov-15 18:55 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.