PureBasic

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

PureBasic

IncludeFile "CkZip.pb"
IncludeFile "CkZipEntry.pb"

Procedure ChilkatExample()

    success.i = 0

    success = 0

    ; Open an existing ZIP archive.
    zip.i = CkZip::ckCreate()
    If zip.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    success = CkZip::ckOpenZip(zip,"example.zip")
    If success = 0
        Debug CkZip::ckLastErrorText(zip)
        CkZip::ckDispose(zip)
        ProcedureReturn
    EndIf

    entry.i = CkZipEntry::ckCreate()
    If entry.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

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

    success = CkZip::ckEntryMatching(zip,"*.png",entry)

    If success = 1
        Debug "Found PNG file:"
        Debug "  " + CkZipEntry::ckFileName(entry)
        Debug ""
    EndIf

    ; ------------------------------------------------------------
    ; 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 = CkZip::ckEntryMatching(zip,"docs/*",entry)

    If success = 1
        Debug "First matching docs entry:"
        Debug "  " + CkZipEntry::ckFileName(entry)
        Debug "  IsDirectory = " + Str(CkZipEntry::ckIsDirectory(entry))
        Debug ""
    EndIf

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

    success = CkZip::ckEntryMatching(zip,"*.json",entry)

    If success = 1
        Debug "Found JSON file:"
        Debug "  " + CkZipEntry::ckFileName(entry)
        Debug ""
    EndIf

    ; ------------------------------------------------------------
    ; 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::ckCloseZip(zip)

    Debug "Done."


    CkZip::ckDispose(zip)
    CkZipEntry::ckDispose(entry)


    ProcedureReturn
EndProcedure