Dart 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

Dart

import 'package:chilkat/chilkat.dart';

void main() {
  var success = false;

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

  success = false;

  // Open an existing ZIP archive.
  final zip = CkZip();

  try {
    zip.openZip('example.zip');
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  final entry = CkZipEntry();

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

  success = zip.entryOf('docs/readme.txt', entry);

  if (success) {
    print('Found file entry:');
    print('  FileName = ${entry.fileName}');
    print('  IsDirectory = ${entry.isDirectory}');
    print('');
  }

  // ------------------------------------------------------------
  // 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);

  if (success) {
    print('Found directory entry:');
    print('  FileName = ${entry.fileName}');
    print('  IsDirectory = ${entry.isDirectory}');
    print('');
  }

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

  success = zip.entryOf('images/missing.png', entry);

  if (!success) {
    print('The entry images/missing.png was not found.');
  }

  zip.closeZip();

  print('Done.');
}