Objective-C

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

Objective-C

#import <CkoZip.h>
#import <CkoZipEntry.h>

BOOL success = NO;

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

success = NO;

//  Open an existing ZIP archive.
CkoZip *zip = [[CkoZip alloc] init];

success = [zip OpenZip: @"example.zip"];
if (success == NO) {
    NSLog(@"%@",zip.LastErrorText);
    return;
}

CkoZipEntry *entry = [[CkoZipEntry alloc] init];

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

success = [zip EntryOf: @"docs/readme.txt" entry: entry];

if (success == YES) {
    NSLog(@"%@",@"Found file entry:");
    NSLog(@"%@%@",@"  FileName = ",entry.FileName);
    NSLog(@"%@%d",@"  IsDirectory = ",entry.IsDirectory);
    NSLog(@"%@",@"");
}

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

success = [zip EntryOf: @"docs/" entry: entry];

if (success == YES) {
    NSLog(@"%@",@"Found directory entry:");
    NSLog(@"%@%@",@"  FileName = ",entry.FileName);
    NSLog(@"%@%d",@"  IsDirectory = ",entry.IsDirectory);
    NSLog(@"%@",@"");
}

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

success = [zip EntryOf: @"images/missing.png" entry: entry];

if (success == NO) {
    NSLog(@"%@",@"The entry images/missing.png was not found.");
}

[zip CloseZip];

NSLog(@"%@",@"Done.");