Introduction
This article is an addendum to my previous article "C++ wrapper for Gilles Vollant's Unzip API".
That article provided a Win32 C++ class (CUnzipper
) for simple querying and unzipping of single and multi-file zip files. What I've done now is to complete the work by adding an equivalent class (CZipper
) for zipping files and folders.
The code link above contains the source both for zipping and unzipping.
Implementation
The CZipper
class interface provides two approaches to zipping:
- For simple file and folder zipping, you can use the static
ZipFile(...)
or ZipFolder(...)
methods.
- For more complex zipping requirements, you can alternatively instantiate a
CZipper
object, then use OpenZip(...)
, followed by one or more AddFileToZip(...)
or AddFolderToZip(...)
calls, before ending with CloseZip()
.
The following features are supported:
- By default, the folder where the zip is saved, is assumed to be the common root of all the files/folders to be added (which is then removed before the files are added to the zip).
- However, you can supply an alternative root if you wish to save the zip to a location other than the common root.
- Files/folders can be added by relative or absolute path, although ..\ is not acceptable as the resulting full path would not be within the common root folder.
- For reasons that I can't immediately think of, you can also elect to have all path information removed, prior to adding to the zip. i.e., all the files appear as if in one folder regardless of their actual relationship on your hard drive.
Notes
-
In addition to the new code, I have also modified the unzip code to take on board a number of comments made on the original article.
Principally, these relate to the use of _splitpath()
and its companion _makepath()
for parsing and building valid pathnames.
Having been through the process, I can confirm that the days of reverse searching for '\' and '.' and well and truly behind me.
- To use the code in your own project:
- Add zipper.h/.cpp and/or unzipper.h/.cpp to the project depending on your needs
- And the zlib folder in the same relationship as it is to these files in the sample project (this contains the header files to Gilles Volant's API)
- Add zlibstat.lib to the project also (this contains Gilles Volant's API code and the ZLib library)
- Build the project.
Sample project
The sample project allows you to zip and unzip, and is intended as a simple demonstration that the code works correctly.
It's the same code that I used for verifying the wrapper classes.
Copyright
The code is supplied here for you to use and abuse without restriction (excepting the copyright restrictions imposed by those referenced in the Credits section), except that you may not modify it and pass it off as your own.
Credits
- 1.0 Initial Release
- 1.1 Support for adding folders by relative path (thanks to YourArmsOff)
- 1.2 File date/times correctly saved with the zip (thanks to IJamil)
- 1.3
- correctly zips empty folders (thanks to voland2)
- handles zip files opened by relative path (thanks to AlphaDog)
- fixed some bugs relating to how folders are stored (thanks to AlvaChin)
Enjoy!