Xbase++ Requires Chilkat v11.0.0+

Find a ZIP Entry by Exact Path Using EntryOf

See more Zip Examples

This example demonstrates how to use the EntryOf method to find a ZIP entry whose stored path exactly matches a specified path.

Unlike EntryMatching, which performs wildcard matching, EntryOf performs an exact path lookup.

This method is useful when:

• The exact ZIP path is already known
• Retrieving a specific file or directory entry
• Verifying whether a particular entry exists in the ZIP archive

Suppose the ZIP archive contains:

docs/
docs/readme.txt
docs/manual.pdf
images/logo.png
data/config/settings.json

ZIP archives may optionally contain explicit directory entries such as docs/. These directory entries can also be retrieved using EntryOf.

The example:

• Finds an exact file entry
• Finds an exact directory entry
• Demonstrates the difference between file and directory entries

Xbase++

LOCAL nSuccess
LOCAL oZip
LOCAL oEntry

nSuccess := 0

//  This example assumes the Chilkat API to have been previously unlocked.
//  See Global Unlock Sample for sample code.

nSuccess := 0

//  Open an existing ZIP archive.
oZip := CreateObject("Chilkat.Zip")

nSuccess := oZip:OpenZip("example.zip")
IF (nSuccess == 0)
    ? oZip:LastErrorText
    oZip:destroy()
    RETURN
ENDIF

oEntry := CreateObject("Chilkat.ZipEntry")

//  ------------------------------------------------------------
//  Find a specific file entry by its exact ZIP path.

nSuccess := oZip:EntryOf("docs/readme.txt", oEntry)

IF (nSuccess == 1)
    ? "Found file entry:"
    ? "  FileName = " + oEntry:FileName
    ? "  IsDirectory = " + Str(oEntry:IsDirectory)
    ? ""
ENDIF

//  ------------------------------------------------------------
//  Find a directory entry.
//  
//  ZIP archives may optionally contain explicit directory entries.
//  In this example, "docs/" is a separate directory entry.

nSuccess := oZip:EntryOf("docs/", oEntry)

IF (nSuccess == 1)
    ? "Found directory entry:"
    ? "  FileName = " + oEntry:FileName
    ? "  IsDirectory = " + Str(oEntry:IsDirectory)
    ? ""
ENDIF

//  ------------------------------------------------------------
//  Attempt to find a non-existent entry.

nSuccess := oZip:EntryOf("images/missing.png", oEntry)

IF (nSuccess == 0)
    ? "The entry images/missing.png was not found."
ENDIF

oZip:CloseZip()

? "Done."

oZip:destroy()
oEntry:destroy()