Unicode C

Iterate Through Matching ZIP Entries Using EntryMatching and ZipEntry.GetNextMatch

See more Zip Examples

This example demonstrates how to iterate through ZIP entries matching a wildcard pattern using:

• Zip.EntryMatching to obtain the first matching entry
• ZipEntry.GetNextMatch to advance to subsequent matching entries

The wildcard character * matches zero or more characters. Matching is performed against the full stored ZIP entry path.

The example searches for all entries beneath the docs/ directory.

Suppose the ZIP archive contains:

docs/
docs/readme.txt
docs/manual.pdf
docs/sub1/notes.txt
images/logo.png
hello.txt

The wildcard pattern:

docs/*

Matches:

docs/
docs/readme.txt
docs/manual.pdf
docs/sub1/notes.txt

Note that ZIP archives may optionally contain separate directory entries. Therefore, the first matching entry may be the directory entry docs/ rather than a file entry.

Unicode C

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

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

    success = FALSE;

    zip = CkZipW_Create();

    // Open an existing ZIP archive.
    success = CkZipW_OpenZip(zip,L"c:/temp/sample.zip");
    if (success == FALSE) {
        wprintf(L"%s\n",CkZipW_lastErrorText(zip));
        CkZipW_Dispose(zip);
        return;
    }

    // ------------------------------------------------------------
    // Find the first ZIP entry matching the wildcard pattern:
    // 
    //     docs/*
    // 
    // Matching is performed against the full stored ZIP path.
    // 
    entry = CkZipEntryW_Create();

    success = CkZipW_EntryMatching(zip,L"docs/*",entry);
    if (success == FALSE) {
        wprintf(L"No matching entries found.\n");
        CkZipW_CloseZip(zip);
        CkZipW_Dispose(zip);
        CkZipEntryW_Dispose(entry);
        return;
    }

    // ------------------------------------------------------------
    // Iterate through all matching entries.
    // 
    // GetNextMatch updates the same ZipEntry object so that
    // it represents the next matching entry.
    // 
    while ((success == TRUE)) {
        if (CkZipEntryW_getIsDirectory(entry) == TRUE) {
            wprintf(L"[Directory] %s\n",CkZipEntryW_fileName(entry));
        }
        else {
            wprintf(L"[File] %s\n",CkZipEntryW_fileName(entry));
        }

        // Advance to the next matching entry.
        success = CkZipEntryW_GetNextMatch(entry,L"docs/*");
    }

    CkZipW_CloseZip(zip);

    wprintf(L"Done.\n");


    CkZipW_Dispose(zip);
    CkZipEntryW_Dispose(entry);

    }