Unicode 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.

Unicode C

#include <C_CkZipW.h>
#include <C_CkZipEntryW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkZipW zip;
    HCkZipW zip2;
    HCkZipEntryW entry;

    success = FALSE;

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

    zip = CkZipW_Create();

    success = CkZipW_NewZip(zip,L"c:/temp/sampleText.zip");
    if (success == FALSE) {
        wprintf(L"%s\n",CkZipW_lastErrorText(zip));
        CkZipW_Dispose(zip);
        return;
    }

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

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

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

    zip2 = CkZipW_Create();

    success = CkZipW_OpenZip(zip2,L"c:/temp/sampleText.zip");
    if (success == FALSE) {
        wprintf(L"%s\n",CkZipW_lastErrorText(zip2));
        CkZipW_Dispose(zip);
        CkZipW_Dispose(zip2);
        return;
    }

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

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

    if (success == FALSE) {
        wprintf(L"Entry not found.\n");
        CkZipW_Dispose(zip);
        CkZipW_Dispose(zip2);
        CkZipEntryW_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 = CkZipEntryW_Extract(entry,L"c:/temp/extracted");
    if (success == FALSE) {
        wprintf(L"%s\n",CkZipEntryW_lastErrorText(entry));
        CkZipW_Dispose(zip);
        CkZipW_Dispose(zip2);
        CkZipEntryW_Dispose(entry);
        return;
    }

    CkZipW_CloseZip(zip2);

    wprintf(L"Entry extracted successfully.\n");


    CkZipW_Dispose(zip);
    CkZipW_Dispose(zip2);
    CkZipEntryW_Dispose(entry);

    }