Unicode C

Add a Common Root Directory to ZIP Entries Using PathPrefix

See more Zip Examples

This example demonstrates how to use the PathPrefix property to prepend a common directory path to all entries added to a ZIP archive.

The PathPrefix value is prepended to the stored ZIP paths for subsequently added entries.

This is useful when:

• Creating ZIP archives that extract beneath a single root directory
• Packaging applications or projects into a named top-level folder
• Avoiding extraction directly into the current directory
• Organizing ZIP contents beneath a common parent directory

Suppose the local filesystem contains:

c:/MyProject/src/main.cpp
c:/MyProject/src/util.cpp
c:/MyProject/docs/readme.txt

And suppose the following code is executed:

zip.PathPrefix = "MyProject/";

Then the ZIP archive will contain:

MyProject/src/main.cpp
MyProject/src/util.cpp
MyProject/docs/readme.txt

Without a PathPrefix, the ZIP archive would instead contain:

src/main.cpp
src/util.cpp
docs/readme.txt

The PathPrefix is applied only to entries added after the property is set.

Unicode C

#include <C_CkZipW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkZipW zip;
    BOOL recurse;

    success = FALSE;

    zip = CkZipW_Create();

    // Create a new ZIP archive.
    success = CkZipW_NewZip(zip,L"MyProject.zip");
    if (success == FALSE) {
        wprintf(L"%s\n",CkZipW_lastErrorText(zip));
        CkZipW_Dispose(zip);
        return;
    }

    // Prepend "MyProject/" to all subsequently added ZIP entries.
    // 
    // This causes all files to extract beneath a top-level
    // directory named "MyProject".
    CkZipW_putPathPrefix(zip,L"MyProject/");

    // Recursively add project files.
    // 
    // Because saveExtraPath = FALSE, the stored ZIP paths
    // will normally begin with:
    // 
    //     src/
    //     docs/
    // 
    // But because PathPrefix = "MyProject/",
    // the final ZIP paths become:
    // 
    //     MyProject/src/
    //     MyProject/docs/
    // 
    recurse = TRUE;
    success = CkZipW_AppendFiles(zip,L"c:/MyProject/*",recurse);

    if (success == FALSE) {
        wprintf(L"%s\n",CkZipW_lastErrorText(zip));
        CkZipW_Dispose(zip);
        return;
    }

    // Write the ZIP archive and close it.
    success = CkZipW_WriteZipAndClose(zip);
    if (success == FALSE) {
        wprintf(L"%s\n",CkZipW_lastErrorText(zip));
        CkZipW_Dispose(zip);
        return;
    }

    wprintf(L"ZIP archive created successfully.\n");


    CkZipW_Dispose(zip);

    }