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

C++

#include <CkZip.h>
#include <CkZipEntry.h>

void ChilkatSample(void)
    {
    bool 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.
    CkZip zip;

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

    CkZipEntry entry;

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

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

    if (success == true) {
        std::cout << "Found file entry:" << "\r\n";
        std::cout << "  FileName = " << entry.fileName() << "\r\n";
        std::cout << "  IsDirectory = " << entry.get_IsDirectory() << "\r\n";
        std::cout << "" << "\r\n";
    }

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

    success = zip.EntryOf("docs/",entry);

    if (success == true) {
        std::cout << "Found directory entry:" << "\r\n";
        std::cout << "  FileName = " << entry.fileName() << "\r\n";
        std::cout << "  IsDirectory = " << entry.get_IsDirectory() << "\r\n";
        std::cout << "" << "\r\n";
    }

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

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

    if (success == false) {
        std::cout << "The entry images/missing.png was not found." << "\r\n";
    }

    zip.CloseZip();

    std::cout << "Done." << "\r\n";
    }