Lua

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.

Lua

local chilkat = require("chilkat")

local zip = chilkat.Zip.new()

-- Open an existing ZIP archive.
local success = zip:open_zip("c:/temp/sample.zip")
if not success then
    print(zip.last_error_text)
    return
end

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

success = zip:entry_matching("docs/*", entry)
if not success then
    print("No matching entries found.")
    zip:close_zip()
    return
end

-- ------------------------------------------------------------
-- Iterate through all matching entries.
--
-- GetNextMatch updates the same ZipEntry object so that
-- it represents the next matching entry.
--
while success do
    if entry.is_directory then
        print("[Directory] " .. entry.file_name)
    else
        print("[File] " .. entry.file_name)
    end

    -- Advance to the next matching entry.
    success = entry:get_next_match("docs/*")
end

zip:close_zip()

print("Done.")