Android™

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

Android™

// Important: Don't forget to include the call to System.loadLibrary
// as shown at the bottom of this code sample.
package com.test;

import android.app.Activity;
import com.chilkatsoft.*;

import android.widget.TextView;
import android.os.Bundle;

public class SimpleActivity extends Activity {

  private static final String TAG = "Chilkat";

  // Called when the activity is first created.
  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    boolean success = false;

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

    success = zip.OpenZip("example.zip");
    if (success == false) {
        Log.i(TAG, zip.lastErrorText());
        return;
        }

    CkZipEntry entry = new CkZipEntry();

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

    success = zip.EntryMatching("*.png",entry);

    if (success == true) {
        Log.i(TAG, "Found PNG file:");
        Log.i(TAG, "  " + entry.fileName());
        Log.i(TAG, "");
        }

    //  ------------------------------------------------------------
    //  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.

    success = zip.EntryMatching("docs/*",entry);

    if (success == true) {
        Log.i(TAG, "First matching docs entry:");
        Log.i(TAG, "  " + entry.fileName());
        Log.i(TAG, "  IsDirectory = " + String.valueOf(entry.get_IsDirectory()));
        Log.i(TAG, "");
        }

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

    success = zip.EntryMatching("*.json",entry);

    if (success == true) {
        Log.i(TAG, "Found JSON file:");
        Log.i(TAG, "  " + entry.fileName());
        Log.i(TAG, "");
        }

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

    Log.i(TAG, "Done.");

  }

  static {
      System.loadLibrary("chilkat");

      // Note: If the incorrect library name is passed to System.loadLibrary,
      // then you will see the following error message at application startup:
      //"The application <your-application-name> has stopped unexpectedly. Please try again."
  }
}