(Delphi DLL) 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

Note: This example requires Chilkat v11.0.0 or greater.

Chilkat for Delphi Downloads Chilkat non-ActiveX DLL for Delphi Chilkat ActiveX DLL for Delphi * The examples here use the non-ActiveX DLL.

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, ZipEntry, Zip;

...

procedure TForm1.Button1Click(Sender: TObject);
var
success: Boolean;
zip: HCkZip;
entry: HCkZipEntry;

begin
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.
zip := CkZip_Create();

success := CkZip_OpenZip(zip,'example.zip');
if (success = False) then
  begin
    Memo1.Lines.Add(CkZip__lastErrorText(zip));
    Exit;
  end;

entry := CkZipEntry_Create();

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

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

if (success = True) then
  begin
    Memo1.Lines.Add('Found file entry:');
    Memo1.Lines.Add('  FileName = ' + CkZipEntry__fileName(entry));
    Memo1.Lines.Add('  IsDirectory = ' + IntToStr(Ord(CkZipEntry_getIsDirectory(entry))));
    Memo1.Lines.Add('');
  end;

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

success := CkZip_EntryOf(zip,'docs/',entry);

if (success = True) then
  begin
    Memo1.Lines.Add('Found directory entry:');
    Memo1.Lines.Add('  FileName = ' + CkZipEntry__fileName(entry));
    Memo1.Lines.Add('  IsDirectory = ' + IntToStr(Ord(CkZipEntry_getIsDirectory(entry))));
    Memo1.Lines.Add('');
  end;

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

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

if (success = False) then
  begin
    Memo1.Lines.Add('The entry images/missing.png was not found.');
  end;

CkZip_CloseZip(zip);

Memo1.Lines.Add('Done.');

CkZip_Dispose(zip);
CkZipEntry_Dispose(entry);

end;