Lua 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

Lua

local chilkat = require("chilkat")

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

local success = false

-- Open an existing ZIP archive.
local zip = chilkat.Zip.new()

success = zip:open_zip("example.zip")
if not success then
    print(zip.last_error_text)
    return
end

local entry = chilkat.ZipEntry.new()

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

success = zip:entry_of("docs/readme.txt", entry)

if success then
    print("Found file entry:")
    print("  FileName = " .. entry.file_name)
    print("  IsDirectory = " .. tostring(entry.is_directory))
    print("")
end

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

success = zip:entry_of("docs/", entry)

if success then
    print("Found directory entry:")
    print("  FileName = " .. entry.file_name)
    print("  IsDirectory = " .. tostring(entry.is_directory))
    print("")
end

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

success = zip:entry_of("images/missing.png", entry)

if not success then
    print("The entry images/missing.png was not found.")
end

zip:close_zip()

print("Done.")