Perl

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

Perl

use chilkat();

$success = 0;

$success = 0;

# Open an existing ZIP archive.
$zip = chilkat::CkZip->new();

$success = $zip->OpenZip("example.zip");
if ($success == 0) {
    print $zip->lastErrorText() . "\r\n";
    exit;
}

$entry = chilkat::CkZipEntry->new();

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

$success = $zip->EntryMatching("*.png",$entry);

if ($success == 1) {
    print "Found PNG file:" . "\r\n";
    print "  " . $entry->fileName() . "\r\n";
    print "" . "\r\n";
}

# ------------------------------------------------------------
# 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->EntryMatching("docs/*",$entry);

if ($success == 1) {
    print "First matching docs entry:" . "\r\n";
    print "  " . $entry->fileName() . "\r\n";
    print "  IsDirectory = " . $entry->get_IsDirectory() . "\r\n";
    print "" . "\r\n";
}

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

$success = $zip->EntryMatching("*.json",$entry);

if ($success == 1) {
    print "Found JSON file:" . "\r\n";
    print "  " . $entry->fileName() . "\r\n";
    print "" . "\r\n";
}

# ------------------------------------------------------------
# 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->CloseZip();

print "Done." . "\r\n";