React Native Requires Chilkat v11.0.0+

Find ZIP Entries Matching a Wildcard Pattern Using EntryMatching

See more Zip Examples

This example demonstrates how to use the EntryMatching method to find ZIP entries whose stored paths match a wildcard pattern.

The wildcard character * matches zero or more characters. The comparison is performed against the full stored path within the ZIP archive.

This method is useful for:

• Finding files having a particular extension
• Locating files within specific subdirectories
• Searching ZIP archives without manually iterating through every entry

Suppose the ZIP archive contains:

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

Notice that the ZIP archive contains an explicit directory entry named docs/. ZIP archives may optionally contain separate directory entries in addition to file entries.

When searching with the pattern docs/*, the first matching entry could therefore be the directory entry docs/ rather than a file contained within that directory.

The example searches for:

• The first .png file
• The first entry beneath the docs directory
• The first JSON file anywhere within the ZIP archive

React Native

import { Zip, ZipEntry } from '@chilkat/react-native'

async function chilkatExample() {
  // Open an existing ZIP archive.
  const zip = new Zip();

  try {
    await zip.openZipAsync('example.zip');
  } catch {
    console.log(zip.lastErrorText);
    return;
  }

  const entry = new ZipEntry();

  // ------------------------------------------------------------
  // Find the first .png file in the ZIP archive.

  try {
    zip.entryMatching('*.png', entry);
    console.log('Found PNG file:');
    console.log(`  ${entry.fileName}`);
    console.log('');
  } catch {
    // zip.entryMatching() failed; continue anyway.
  }

  // ------------------------------------------------------------
  // Find the first entry beneath the docs directory.
  // 
  // Note: ZIP archives may optionally contain explicit directory
  // entries such as "docs/" in addition to file entries.
  // Therefore, the first matching entry could be the directory
  // itself rather than a file contained within the directory.

  try {
    zip.entryMatching('docs/*', entry);
    console.log('First matching docs entry:');
    console.log(`  ${entry.fileName}`);
    console.log(`  IsDirectory = ${entry.isDirectory}`);
    console.log('');
  } catch {
    // zip.entryMatching() failed; continue anyway.
  }

  // ------------------------------------------------------------
  // Find the first JSON file anywhere in the ZIP archive.

  try {
    zip.entryMatching('*.json', entry);
    console.log('Found JSON file:');
    console.log(`  ${entry.fileName}`);
    console.log('');
  } catch {
    // zip.entryMatching() failed; continue anyway.
  }

  // ------------------------------------------------------------
  // The matching is performed against the full stored ZIP path.
  // For example:
  // 
  //     docs/readme.txt
  //     images/logo.png
  //     data/config/settings.json
  // 
  // The wildcard '*' matches zero or more characters.

  zip.closeZip();

  console.log('Done.');
}