Lazarus Pascal 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

Lazarus Pascal

program ChilkatDemo;

// Demonstrates using the Chilkat Pascal wrapper via the C bridge DLL.
// Builds as a console application under Lazarus (FPC) or Delphi.

{$IFDEF FPC}
  {$MODE DELPHI}
{$ENDIF}
{$APPTYPE CONSOLE}

uses
  {$IFDEF UNIX}
  cthreads,
  {$ENDIF}
  SysUtils,
  CkDllLoader,
  Chilkat.ZipEntry,
  Chilkat.Zip;

// ---------------------------------------------------------------------------

procedure RunDemo;
var
  success: Boolean;
  zip: TZip;
  entry: TZipEntry;

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 := TZip.Create;

  success := zip.OpenZip('example.zip');
  if (success = False) then
    begin
      WriteLn(zip.LastErrorText);
      Exit;
    end;

  entry := TZipEntry.Create;

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

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

  if (success = True) then
    begin
      WriteLn('Found file entry:');
      WriteLn('  FileName = ' + entry.FileName);
      WriteLn('  IsDirectory = ' + entry.IsDirectory);
      WriteLn('');
    end;

  //  ------------------------------------------------------------
  //  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 = True) then
    begin
      WriteLn('Found directory entry:');
      WriteLn('  FileName = ' + entry.FileName);
      WriteLn('  IsDirectory = ' + entry.IsDirectory);
      WriteLn('');
    end;

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

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

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

  zip.CloseZip();

  WriteLn('Done.');


  zip.Free;
  entry.Free;

end;

// ---------------------------------------------------------------------------

begin

  try
    RunDemo;
  except
    on E: Exception do
      WriteLn('Unhandled exception: ', E.ClassName, ': ', E.Message);
  end;

  WriteLn;
  {$IFDEF MSWINDOWS}
  WriteLn('Press Enter to exit...');
  ReadLn;
  {$ENDIF}
end.