Tcl

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

Tcl

load ./chilkat.dll

set success 0

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

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 a specific file entry by its exact ZIP path.

set success [CkZip_EntryOf $zip "docs/readme.txt" $entry]

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

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

set success [CkZip_EntryOf $zip "docs/" $entry]

if {$success == 1} then {
    puts "Found directory entry:"
    puts "  FileName = [CkZipEntry_fileName $entry]"
    puts "  IsDirectory = [CkZipEntry_get_IsDirectory $entry]"
    puts 
}

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

set success [CkZip_EntryOf $zip "images/missing.png" $entry]

if {$success == 0} then {
    puts "The entry images/missing.png was not found."
}

CkZip_CloseZip $zip

puts "Done."

delete_CkZip $zip
delete_CkZipEntry $entry