C

Extract a Single ZIP Entry While Preserving Its Stored Path

See more Zip Examples

This example demonstrates how to use the ZipEntry.Extract method to extract a single entry from a ZIP archive.

The example first creates a ZIP archive containing a text file. It then re-opens the ZIP, finds the entry, and extracts it to a base directory.

The Extract method uses the relative path stored within the ZIP entry. Any required subdirectories are created automatically beneath the specified base directory.

C

#include <C_CkZip.h>
#include <C_CkZipEntry.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkZip zip;
    HCkZip zip2;
    HCkZipEntry entry;

    success = FALSE;

    // ------------------------------------------------------------
    // First create a sample ZIP archive containing a small text file.

    zip = CkZip_Create();

    success = CkZip_NewZip(zip,"c:/temp/sampleText.zip");
    if (success == FALSE) {
        printf("%s\n",CkZip_lastErrorText(zip));
        CkZip_Dispose(zip);
        return;
    }

    // Add a small text file from memory.
    success = CkZip_AddString(zip,"myApp/docs/hello.txt","Hello from a ZIP entry!","utf-8");
    if (success == FALSE) {
        printf("%s\n",CkZip_lastErrorText(zip));
        CkZip_Dispose(zip);
        return;
    }

    // Write the ZIP archive to disk and close it.
    success = CkZip_WriteZipAndClose(zip);
    if (success == FALSE) {
        printf("%s\n",CkZip_lastErrorText(zip));
        CkZip_Dispose(zip);
        return;
    }

    // ------------------------------------------------------------
    // Now open the ZIP archive we just created.

    zip2 = CkZip_Create();

    success = CkZip_OpenZip(zip2,"c:/temp/sampleText.zip");
    if (success == FALSE) {
        printf("%s\n",CkZip_lastErrorText(zip2));
        CkZip_Dispose(zip);
        CkZip_Dispose(zip2);
        return;
    }

    // Find the entry by its stored ZIP path.
    entry = CkZipEntry_Create();

    success = CkZip_EntryOf(zip2,"myApp/docs/hello.txt",entry);

    if (success == FALSE) {
        printf("Entry not found.\n");
        CkZip_Dispose(zip);
        CkZip_Dispose(zip2);
        CkZipEntry_Dispose(entry);
        return;
    }

    // Extract this single entry to the base directory:
    // 
    //     c:/temp/extracted
    // 
    // Because the entry's stored path is:
    // 
    //     myApp/docs/hello.txt
    // 
    // the file will be extracted to:
    // 
    //     qa_output/extracted/myApp/docs/hello.txt
    // 
    // The required subdirectories are created automatically.
    success = CkZipEntry_Extract(entry,"c:/temp/extracted");
    if (success == FALSE) {
        printf("%s\n",CkZipEntry_lastErrorText(entry));
        CkZip_Dispose(zip);
        CkZip_Dispose(zip2);
        CkZipEntry_Dispose(entry);
        return;
    }

    CkZip_CloseZip(zip2);

    printf("Entry extracted successfully.\n");


    CkZip_Dispose(zip);
    CkZip_Dispose(zip2);
    CkZipEntry_Dispose(entry);

    }