Tcl 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

Tcl

load ./chilkat.dll

set success 0

#  Open an existing ZIP archive.
set zip [new_CkZip]

set success [CkZip_OpenZip $zip "example.zip"]
if {$success == 0} then {
    puts [CkZip_lastErrorText $zip]
    delete_CkZip $zip
    exit
}

set entry [new_CkZipEntry]

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

set success [CkZip_EntryMatching $zip "*.png" $entry]

if {$success == 1} then {
    puts "Found PNG file:"
    puts "  [CkZipEntry_fileName $entry]"
    puts ""
}

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

set success [CkZip_EntryMatching $zip "docs/*" $entry]

if {$success == 1} then {
    puts "First matching docs entry:"
    puts "  [CkZipEntry_fileName $entry]"
    puts "  IsDirectory = [CkZipEntry_get_IsDirectory $entry]"
    puts ""
}

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

set success [CkZip_EntryMatching $zip "*.json" $entry]

if {$success == 1} then {
    puts "Found JSON file:"
    puts "  [CkZipEntry_fileName $entry]"
    puts ""
}

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

CkZip_CloseZip $zip

puts "Done."

delete_CkZip $zip
delete_CkZipEntry $entry