C++

Append Files to an Existing ZIP Archive Using QuickAppend

See more Zip Examples

Demonstrates how to use the QuickAppend method to append additional files to an existing ZIP archive.

Unlike methods that rewrite the entire ZIP archive, QuickAppend modifies the existing ZIP in-place by appending new entries directly to the end of the archive.

Existing ZIP entries are not recompressed or rewritten, making QuickAppend the fastest and most efficient way to add files to a large pre-existing ZIP archive.

C++

#include <CkZip.h>

void ChilkatSample(void)
    {
    bool success = false;

    CkZip zip;

    // ------------------------------------------------------------
    // Initialize a new Zip object.
    // 
    // NewZip resets the Zip object to a new and empty state.
    // It does NOT immediately create or write a .zip file.
    // 
    // The filename passed to NewZip is not used by QuickAppend,
    // but NewZip is still useful because it initializes the
    // Zip object to an empty state.
    success = zip.NewZip("notUsed.zip");
    if (success == false) {
        std::cout << zip.lastErrorText() << "\r\n";
        return;
    }

    // ------------------------------------------------------------
    // Add a reference to a local filesystem file.
    // 
    // AddFile does NOT immediately read or compress the file.
    // Instead, it adds a reference to the file that will later
    // be processed when QuickAppend is called.
    // 
    // The file being referenced is:
    // 
    //     c:/temp/files/something.dat
    // 
    bool saveExtraPath = false;

    success = zip.AddFile("c:/temp/files/something.dat",saveExtraPath);

    if (success == false) {
        std::cout << zip.lastErrorText() << "\r\n";
        return;
    }

    // Because saveExtraPath = false,
    // the file will be stored in the ZIP as:
    // 
    //     something.dat
    // 

    // ------------------------------------------------------------
    // Append the referenced files to an existing ZIP archive.
    // 
    // QuickAppend opens the existing ZIP archive:
    // 
    //     c:/temp/zips/preExisting.zip
    // 
    // The referenced files are then:
    // 
    //   * Read from the local filesystem
    //   * Compressed as needed
    //   * Appended to the existing ZIP archive
    // 
    success = zip.QuickAppend("c:/temp/zips/preExisting.zip");
    if (success == false) {
        std::cout << zip.lastErrorText() << "\r\n";
        return;
    }

    std::cout << "Files appended successfully." << "\r\n";
    std::cout << "" << "\r\n";

    // ------------------------------------------------------------
    // Additional files, directory trees, or in-memory data
    // can be added before calling QuickAppend.
    // 
    // For example:
    // 
    //     AddFile
    //     AppendFiles
    //     AppendFilesEx
    //     AddString
    //     AddBd
    //     AddSb
    // 
    // Whatever entries are currently referenced by the Zip object
    // are appended to the existing ZIP archive when QuickAppend
    // is called
    }