Lua

Iterate Through ZIP Entries Using EntryAt and ZipEntry.GetNext

See more Zip Examples

This example demonstrates how to iterate through all entries in a ZIP archive using:

• Zip.EntryAt to obtain the first entry
• ZipEntry.GetNext to advance through the remaining entries

The example prints each ZIP entry's stored filename and whether the entry is a file or directory.

This approach is useful when sequentially processing ZIP entries without repeatedly calling EntryAt by index.

Suppose the ZIP archive contains:

docs/
docs/readme.txt
images/logo.png
hello.txt

The example iterates through each entry in the order stored within the ZIP archive.

Lua

local chilkat = require("chilkat")

local zip = chilkat.Zip.new()

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

-- A ZIP archive may contain zero entries.
if zip.num_entries == 0 then
    print("The ZIP archive is empty.")

    zip:close_zip()
    return
end

-- ------------------------------------------------------------
-- Get the first ZIP entry.
--
-- EntryAt(0,entry) initializes the ZipEntry object so that
-- it represents the first entry in the ZIP archive.
--
local entry = chilkat.ZipEntry.new()

success = zip:entry_at(0, entry)
if not success then
    print(zip.last_error_text)
    return
end

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

    -- Advance to the next entry.
    success = entry:get_next()
end

zip:close_zip()

print("Done.")