Lua 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

Lua

local chilkat = require("chilkat")

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

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

local entry = chilkat.ZipEntry.new()

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

success = zip:entry_matching("*.png", entry)

if success then
    print("Found PNG file:")
    print("  " .. entry.file_name)
    print("")
end

-- ------------------------------------------------------------
-- 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.

success = zip:entry_matching("docs/*", entry)

if success then
    print("First matching docs entry:")
    print("  " .. entry.file_name)
    print("  IsDirectory = " .. tostring(entry.is_directory))
    print("")
end

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

success = zip:entry_matching("*.json", entry)

if success then
    print("Found JSON file:")
    print("  " .. entry.file_name)
    print("")
end

-- ------------------------------------------------------------
-- 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:close_zip()

print("Done.")