Objective-C

Extract a Single ZIP Entry While Preserving Its Stored Path

See more Zip Examples

This example demonstrates how to use the ZipEntry.Extract method to extract a single entry from a ZIP archive.

The example first creates a ZIP archive containing a text file. It then re-opens the ZIP, finds the entry, and extracts it to a base directory.

The Extract method uses the relative path stored within the ZIP entry. Any required subdirectories are created automatically beneath the specified base directory.

Objective-C

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

BOOL success = NO;

//  ------------------------------------------------------------
//  First create a sample ZIP archive containing a small text file.

CkoZip *zip = [[CkoZip alloc] init];

success = [zip NewZip: @"c:/temp/sampleText.zip"];
if (success == NO) {
    NSLog(@"%@",zip.LastErrorText);
    return;
}

//  Add a small text file from memory.
success = [zip AddString: @"myApp/docs/hello.txt" content: @"Hello from a ZIP entry!" charset: @"utf-8"];
if (success == NO) {
    NSLog(@"%@",zip.LastErrorText);
    return;
}

//  Write the ZIP archive to disk and close it.
success = [zip WriteZipAndClose];
if (success == NO) {
    NSLog(@"%@",zip.LastErrorText);
    return;
}

//  ------------------------------------------------------------
//  Now open the ZIP archive we just created.

CkoZip *zip2 = [[CkoZip alloc] init];

success = [zip2 OpenZip: @"c:/temp/sampleText.zip"];
if (success == NO) {
    NSLog(@"%@",zip2.LastErrorText);
    return;
}

//  Find the entry by its stored ZIP path.
CkoZipEntry *entry = [[CkoZipEntry alloc] init];

success = [zip2 EntryOf: @"myApp/docs/hello.txt" entry: entry];

if (success == NO) {
    NSLog(@"%@",@"Entry not found.");
    return;
}

//  Extract this single entry to the base directory:
//  
//      c:/temp/extracted
//  
//  Because the entry's stored path is:
//  
//      myApp/docs/hello.txt
//  
//  the file will be extracted to:
//  
//      qa_output/extracted/myApp/docs/hello.txt
//  
//  The required subdirectories are created automatically.
success = [entry Extract: @"c:/temp/extracted"];
if (success == NO) {
    NSLog(@"%@",entry.LastErrorText);
    return;
}

[zip2 CloseZip];

NSLog(@"%@",@"Entry extracted successfully.");