Unicode C

Find a ZIP Entry by Exact Path Using EntryOf

See more Zip Examples

This example demonstrates how to use the EntryOf method to find a ZIP entry whose stored path exactly matches a specified path.

Unlike EntryMatching, which performs wildcard matching, EntryOf performs an exact path lookup.

This method is useful when:

• The exact ZIP path is already known
• Retrieving a specific file or directory entry
• Verifying whether a particular entry exists in the ZIP archive

Suppose the ZIP archive contains:

docs/
docs/readme.txt
docs/manual.pdf
images/logo.png
data/config/settings.json

ZIP archives may optionally contain explicit directory entries such as docs/. These directory entries can also be retrieved using EntryOf.

The example:

• Finds an exact file entry
• Finds an exact directory entry
• Demonstrates the difference between file and directory entries

Unicode C

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

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

    success = FALSE;

    // This example assumes the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    success = FALSE;

    // Open an existing ZIP archive.
    zip = CkZipW_Create();

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

    entry = CkZipEntryW_Create();

    // ------------------------------------------------------------
    // Find a specific file entry by its exact ZIP path.

    success = CkZipW_EntryOf(zip,L"docs/readme.txt",entry);

    if (success == TRUE) {
        wprintf(L"Found file entry:\n");
        wprintf(L"  FileName = %s\n",CkZipEntryW_fileName(entry));
        wprintf(L"  IsDirectory = %d\n",CkZipEntryW_getIsDirectory(entry));
        wprintf(L"\n");
    }

    // ------------------------------------------------------------
    // Find a directory entry.
    // 
    // ZIP archives may optionally contain explicit directory entries.
    // In this example, "docs/" is a separate directory entry.

    success = CkZipW_EntryOf(zip,L"docs/",entry);

    if (success == TRUE) {
        wprintf(L"Found directory entry:\n");
        wprintf(L"  FileName = %s\n",CkZipEntryW_fileName(entry));
        wprintf(L"  IsDirectory = %d\n",CkZipEntryW_getIsDirectory(entry));
        wprintf(L"\n");
    }

    // ------------------------------------------------------------
    // Attempt to find a non-existent entry.

    success = CkZipW_EntryOf(zip,L"images/missing.png",entry);

    if (success == FALSE) {
        wprintf(L"The entry images/missing.png was not found.\n");
    }

    CkZipW_CloseZip(zip);

    wprintf(L"Done.\n");


    CkZipW_Dispose(zip);
    CkZipEntryW_Dispose(entry);

    }