Zig Requires Chilkat v11.0.0+

Find ZIP Entries Matching a Wildcard Pattern Using EntryMatching

See more Zip Examples

This example demonstrates how to use the EntryMatching method to find ZIP entries whose stored paths match a wildcard pattern.

The wildcard character * matches zero or more characters. The comparison is performed against the full stored path within the ZIP archive.

This method is useful for:

• Finding files having a particular extension
• Locating files within specific subdirectories
• Searching ZIP archives without manually iterating through every entry

Suppose the ZIP archive contains:

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

Notice that the ZIP archive contains an explicit directory entry named docs/. ZIP archives may optionally contain separate directory entries in addition to file entries.

When searching with the pattern docs/*, the first matching entry could therefore be the directory entry docs/ rather than a file contained within that directory.

The example searches for:

• The first .png file
• The first entry beneath the docs directory
• The first JSON file anywhere within the ZIP archive

Zig

const std = @import("std");
const chilkat = @import("chilkat");

pub fn main(init: std.process.Init) !void {
    const alloc = init.arena.allocator();

    // Open an existing ZIP archive.
    const zip = try chilkat.Zip.init();
    defer zip.deinit();

    zip.openZip("example.zip") catch {
        std.debug.print("{s}\n", .{try zip.getLastErrorText(alloc)});
        return;
    };

    const entry = try chilkat.ZipEntry.init();
    defer entry.deinit();

    // ------------------------------------------------------------
    // Find the first .png file in the ZIP archive.

    if (zip.entryMatching("*.png", entry)) {
        std.debug.print("Found PNG file:\n", .{});
        std.debug.print("  {s}\n", .{try entry.getFileName(alloc)});
        std.debug.print("\n", .{});
    } else |_| {}

    // ------------------------------------------------------------
    // Find the first entry beneath the docs directory.
    //
    // Note: ZIP archives may optionally contain explicit directory
    // entries such as "docs/" in addition to file entries.
    // Therefore, the first matching entry could be the directory
    // itself rather than a file contained within the directory.

    if (zip.entryMatching("docs/*", entry)) {
        std.debug.print("First matching docs entry:\n", .{});
        std.debug.print("  {s}\n", .{try entry.getFileName(alloc)});
        std.debug.print("  IsDirectory = {}\n", .{entry.getIsDirectory()});
        std.debug.print("\n", .{});
    } else |_| {}

    // ------------------------------------------------------------
    // Find the first JSON file anywhere in the ZIP archive.

    if (zip.entryMatching("*.json", entry)) {
        std.debug.print("Found JSON file:\n", .{});
        std.debug.print("  {s}\n", .{try entry.getFileName(alloc)});
        std.debug.print("\n", .{});
    } else |_| {}

    // ------------------------------------------------------------
    // The matching is performed against the full stored ZIP path.
    // For example:
    //
    //     docs/readme.txt
    //     images/logo.png
    //     data/config/settings.json
    //
    // The wildcard '*' matches zero or more characters.

    zip.closeZip();

    std.debug.print("Done.\n", .{});
}