FGx
1
|
#include <zip.h>
Public Types | |
enum | ErrorCode { Ok, ZlibInit, ZlibError, FileExists, OpenFailed, NoOpenArchive, FileNotFound, ReadFailed, WriteFailed, SeekFailed } |
enum | CompressionLevel { Store, Deflate1 = 1, Deflate2, Deflate3, Deflate4, Deflate5, Deflate6, Deflate7, Deflate8, Deflate9, AutoCPU, AutoMIME, AutoFull } |
enum | CompressionOption { RelativePaths = 0x0001, AbsolutePaths = 0x0002, IgnorePaths = 0x0004 } |
Public Member Functions | |
Zip () | |
virtual | ~Zip () |
bool | isOpen () const |
void | setPassword (const QString &pwd) |
void | clearPassword () |
Convenience method, clears the current password. | |
QString | password () const |
Returns the currently used password. | |
ErrorCode | createArchive (const QString &file, bool overwrite=true) |
ErrorCode | createArchive (QIODevice *device) |
QString | archiveComment () const |
void | setArchiveComment (const QString &comment) |
ErrorCode | addDirectoryContents (const QString &path, CompressionLevel level=AutoFull) |
ErrorCode | addDirectoryContents (const QString &path, const QString &root, CompressionLevel level=AutoFull) |
ErrorCode | addDirectory (const QString &path, CompressionOptions options=RelativePaths, CompressionLevel level=AutoFull) |
ErrorCode | addDirectory (const QString &path, const QString &root, CompressionLevel level=AutoFull) |
ErrorCode | addDirectory (const QString &path, const QString &root, CompressionOptions options=RelativePaths, CompressionLevel level=AutoFull) |
ErrorCode | closeArchive () |
QString | formatError (ErrorCode c) const |
Zip file compression.
Some quick usage examples.
Suppose you have this directory structure: /root/dir1/ /root/dir1/file1.1 /root/dir1/file1.2 /root/dir1/dir1.1/ /root/dir1/dir1.2/file1.2.1 EXAMPLE 1: myZipInstance.addDirectory("/root/dir1"); RESULT: Beheaves like any common zip software and creates a zip file with this structure: dir1/ dir1/file1.1 dir1/file1.2 dir1/dir1.1/ dir1/dir1.2/file1.2.1 EXAMPLE 2: myZipInstance.addDirectory("/root/dir1", "myRoot/myFolder"); RESULT: Adds a custom root to the paths and creates a zip file with this structure: myRoot/myFolder/dir1/ myRoot/myFolder/dir1/file1.1 myRoot/myFolder/dir1/file1.2 myRoot/myFolder/dir1/dir1.1/ myRoot/myFolder/dir1/dir1.2/file1.2.1 EXAMPLE 3: myZipInstance.addDirectory("/root/dir1", Zip::AbsolutePaths); NOTE: Same as calling addDirectory(SOME_PATH, PARENT_PATH_of_SOME_PATH). RESULT: Preserves absolute paths and creates a zip file with this structure: /root/dir1/ /root/dir1/file1.1 /root/dir1/file1.2 /root/dir1/dir1.1/ /root/dir1/dir1.2/file1.2.1 EXAMPLE 4: myZipInstance.setPassword("hellopass"); myZipInstance.addDirectory("/root/dir1", "/"); RESULT: Adds and encrypts the files in /root/dir1, creating the following zip structure: /dir1/ /dir1/file1.1 /dir1/file1.2 /dir1/dir1.1/ /dir1/dir1.2/file1.2.1
Returns the result of a decompression operation. \value Zip::Store No compression. \value Zip::Deflate1 Deflate compression level 1(lowest compression). \value Zip::Deflate1 Deflate compression level 2. \value Zip::Deflate1 Deflate compression level 3. \value Zip::Deflate1 Deflate compression level 4. \value Zip::Deflate1 Deflate compression level 5. \value Zip::Deflate1 Deflate compression level 6. \value Zip::Deflate1 Deflate compression level 7. \value Zip::Deflate1 Deflate compression level 8. \value Zip::Deflate1 Deflate compression level 9 (maximum compression). \value Zip::AutoCPU Adapt compression level to CPU speed (faster CPU => better compression). \value Zip::AutoMIME Adapt compression level to MIME type of the file being compressed. \value Zip::AutoFull Use both CPU and MIME type detection.
enum Zip::ErrorCode |
The result of a compression operation. \value Zip::Ok No error occurred. \value Zip::ZlibInit Failed to init or load the zlib library. \value Zip::ZlibError The zlib library returned some error. \value Zip::FileExists The file already exists and will not be overwritten. \value Zip::OpenFailed Unable to create or open a device. \value Zip::NoOpenArchive CreateArchive() has not been called yet. \value Zip::FileNotFound File or directory does not exist. \value Zip::ReadFailed Reading of a file failed. \value Zip::WriteFailed Writing of a file failed. \value Zip::SeekFailed Seek failed.
Zip::Zip | ( | ) |
Creates a new Zip file compressor.
|
virtual |
Closes any open archive and releases used resources.
Zip::ErrorCode Zip::addDirectory | ( | const QString & | path, |
CompressionOptions | options = RelativePaths , |
||
CompressionLevel | level = AutoFull |
||
) |
Convenience method, same as calling Zip::addDirectory(const QString&,const QString&,CompressionLevel) with an empty root
parameter (or with the parent directory of path
if the AbsolutePaths options is set).
The ExtractionOptions are checked in the order they are defined in the zip.h heaser file. This means that the last one overwrites the previous one (if some conflict occurs), i.e. Zip::IgnorePaths | Zip::AbsolutePaths would be interpreted as Zip::IgnorePaths.
Zip::ErrorCode Zip::addDirectory | ( | const QString & | path, |
const QString & | root, | ||
CompressionLevel | level = AutoFull |
||
) |
Convenience method, same as calling Zip::addDirectory(const QString&,const QString&,CompressionOptions,CompressionLevel) with the Zip::RelativePaths flag as compression option.
Zip::ErrorCode Zip::addDirectory | ( | const QString & | path, |
const QString & | root, | ||
CompressionOptions | options = RelativePaths , |
||
CompressionLevel | level = AutoFull |
||
) |
Recursively adds files contained in dir
to the archive, using root
as name for the root folder. Stops adding files if some error occurs.
The ExtractionOptions are checked in the order they are defined in the zip.h heaser file. This means that the last one overwrites the previous one (if some conflict occurs), i.e. Zip::IgnorePaths | Zip::AbsolutePaths would be interpreted as Zip::IgnorePaths.
The root
parameter is ignored with the Zip::IgnorePaths parameter and used as path prefix (a trailing / is always added as directory separator!) otherwise (even with Zip::AbsolutePaths set!).
Zip::ErrorCode Zip::addDirectoryContents | ( | const QString & | path, |
CompressionLevel | level = AutoFull |
||
) |
Convenience method, same as calling Zip::addDirectory(const QString&,const QString&,CompressionOptions,CompressionLevel) with the Zip::IgnorePaths flag as compression option and an empty root
parameter.
Zip::ErrorCode Zip::addDirectoryContents | ( | const QString & | path, |
const QString & | root, | ||
CompressionLevel | level = AutoFull |
||
) |
Convenience method, same as calling Zip::addDirectory(const QString&,const QString&,CompressionOptions,CompressionLevel) with the Zip::IgnorePaths flag as compression option.
QString Zip::archiveComment | ( | ) | const |
Returns the current archive comment.
Zip::ErrorCode Zip::closeArchive | ( | ) |
Closes the archive and writes any pending data.
Zip::ErrorCode Zip::createArchive | ( | const QString & | filename, |
bool | overwrite = true |
||
) |
Attempts to create a new Zip archive. If overwrite
is true and the file already exist it will be overwritten. Any open archive will be closed.
Zip::ErrorCode Zip::createArchive | ( | QIODevice * | device | ) |
Attempts to create a new Zip archive. If there is another open archive this will be closed.
QString Zip::formatError | ( | Zip::ErrorCode | c | ) | const |
Returns a locale translated error string for a given error code.
bool Zip::isOpen | ( | ) | const |
Returns true if there is an open archive.
void Zip::setArchiveComment | ( | const QString & | comment | ) |
Sets the comment for this archive. Note: createArchive() should have been called before.
void Zip::setPassword | ( | const QString & | pwd | ) |
Sets the password to be used for the next files being added! Files added before calling this method will use the previously set password (if any). Closing the archive won't clear the password!