PowerBuilder 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

PowerBuilder

integer li_rc
long li_Success
oleobject loo_Zip
oleobject loo_Entry

li_Success = 0

//  Open an existing ZIP archive.
loo_Zip = create oleobject
li_rc = loo_Zip.ConnectToNewObject("Chilkat.Zip")
if li_rc < 0 then
    destroy loo_Zip
    MessageBox("Error","Connecting to COM object failed")
    return
end if

li_Success = loo_Zip.OpenZip("example.zip")
if li_Success = 0 then
    Write-Debug loo_Zip.LastErrorText
    destroy loo_Zip
    return
end if

loo_Entry = create oleobject
li_rc = loo_Entry.ConnectToNewObject("Chilkat.ZipEntry")

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

li_Success = loo_Zip.EntryMatching("*.png",loo_Entry)

if li_Success = 1 then
    Write-Debug "Found PNG file:"
    Write-Debug "  " + loo_Entry.FileName
    Write-Debug ""
end if

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

li_Success = loo_Zip.EntryMatching("docs/*",loo_Entry)

if li_Success = 1 then
    Write-Debug "First matching docs entry:"
    Write-Debug "  " + loo_Entry.FileName
    Write-Debug "  IsDirectory = " + string(loo_Entry.IsDirectory)
    Write-Debug ""
end if

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

li_Success = loo_Zip.EntryMatching("*.json",loo_Entry)

if li_Success = 1 then
    Write-Debug "Found JSON file:"
    Write-Debug "  " + loo_Entry.FileName
    Write-Debug ""
end if

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

loo_Zip.CloseZip()

Write-Debug "Done."


destroy loo_Zip
destroy loo_Entry