Zig Requires Chilkat v11.0.0+

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

Zig

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

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

    var success: bool = 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.
    const zip = try chilkat.Zip.init();
    defer zip.deinit();

    success = if (zip.openZip("example.zip")) true else |_| false;
    if (!success) {
        std.debug.print("{s}\n", .{try zip.getLastErrorText(alloc)});
        return;
    }

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

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

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

    if (success) {
        std.debug.print("Found file entry:\n", .{});
        std.debug.print("  FileName = {s}\n", .{try entry.getFileName(alloc)});
        std.debug.print("  IsDirectory = {}\n", .{entry.getIsDirectory()});
        std.debug.print("\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) {
        std.debug.print("Found directory entry:\n", .{});
        std.debug.print("  FileName = {s}\n", .{try entry.getFileName(alloc)});
        std.debug.print("  IsDirectory = {}\n", .{entry.getIsDirectory()});
        std.debug.print("\n", .{});
    }

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

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

    if (!success) {
        std.debug.print("The entry images/missing.png was not found.\n", .{});
    }

    zip.closeZip();

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