Sample code for 30+ languages & platforms
Delphi DLL Requires Chilkat v9.5.0.76+

FTP Sync Download Tree w/ Must-Match Constraints

See more FTP Examples

Demonstrates how synchronize a directory tree in the download direction, but only for files matching a set of wildcard filenames.

Chilkat Delphi DLL Downloads

Delphi DLL
var
success: Boolean;
ftp: HCkFtp2;
mode: Integer;
st: HCkStringTable;
numFiles: Integer;
i: Integer;
remoteFilename: PWideChar;

begin
success := False;

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

ftp := CkFtp2_Create();

CkFtp2_putHostname(ftp,'ftp.something.com');
CkFtp2_putUsername(ftp,'my_login');
CkFtp2_putPassword(ftp,'my_password');

//  Connect and login to the FTP server.
success := CkFtp2_Connect(ftp);
if (success <> True) then
  begin
    Memo1.Lines.Add(CkFtp2__lastErrorText(ftp));
    Exit;
  end;

//  Set the current remote directory to the root of
//  the tree to be downloaded.
success := CkFtp2_ChangeRemoteDir(ftp,'/subDir1');
if (success <> True) then
  begin
    Memo1.Lines.Add(CkFtp2__lastErrorText(ftp));
    Exit;
  end;

//  Possible synchronization modes are:
//  mode=0: Download all files
//  mode=1: Download all files that do not exist on the local filesystem.
//  mode=2: Download newer or non-existant files.
//  mode=3: Download only newer files. If a file does not already exist on the local filesystem, it is not downloaded from the server..
//  mode=5: Download only missing files or files with size differences.
//  mode=6: Same as mode 5, but also download newer files.

//  This example will download all files, but only those files having filenames
//  that match *.gif and *.eml

//  Imagine our remote directory tree has these files and directories:

//  	accentedLatin1.txt
//  	accentedUtf8.txt
//  	alice.key
//  	anter_cert.pem
//  	chiliPepper.gif
//  	helloWorld.pdf
//  	abc/chiliPepper.gif
//  	abc/ghk/
//  	data/chiliPepper.gif
//  	data/xyz/dkimHtmlBody.txt
//  	data/xyz/dkimVerifyTest.eml
//  	data/xyz/emailForCreateDsn.eml
//  	text/frenchUtf8.txt
//  	text/helloWorld.txt
//  	text/PolishEmailBody.txt
//  	text/something/

//  Indicate that we only want to create auto-create local directories (if needed)
//  for the files that are actually downloaded.  If SyncCreateAllLocalDirs remains
//  1, then the corresponding local directory is created for each remote directory
//  traversed regardless of whether files within are downloaded.
CkFtp2_putSyncCreateAllLocalDirs(ftp,False);

CkFtp2_putSyncMustMatch(ftp,'*.eml; *.gif');
mode := 0;
success := CkFtp2_SyncLocalTree(ftp,'c:/temp/subDir1',mode);
if (success <> True) then
  begin
    Memo1.Lines.Add(CkFtp2__lastErrorText(ftp));
    Exit;
  end;

success := CkFtp2_Disconnect(ftp);

//  Show the files downloaded.
st := CkStringTable_Create();
CkFtp2_GetSyncedFiles(ftp,st);

numFiles := CkStringTable_getCount(st);
i := 0;

while i < numFiles do
  begin
    Memo1.Lines.Add(CkStringTable__stringAt(st,i));
    i := i + 1;
  end;

//  Output showing the files downloaded:

//  chiliPepper.gif
//  abc/chiliPepper.gif
//  data/chiliPepper.gif
//  data/xyz/dkimVerifyTest.eml
//  data/xyz/emailForCreateDsn.eml

CkFtp2_Dispose(ftp);
CkStringTable_Dispose(st);