Delphi DLL

Upload Text to an FTP Server (StringBuilder)

Demonstrates the Chilkat Ftp2.PutFileSb method, which encodes the text in a StringBuilder and uploads it to a remote path. The arguments are the StringBuilder, the charset, whether to include a byte-order mark, and the remote file path.

Background: The text-oriented upload: assemble a document — CSV, config, JSON — in a StringBuilder and the method handles encoding as it writes. The charset governs the bytes actually stored, and the byte-order-mark flag is useful when a consuming Windows application expects a BOM.

Chilkat Delphi DLL Downloads

Download Chilkat for Delphi DLL

Delphi DLL

var
success: Boolean;
ftp: HCkFtp2;
sb: HCkStringBuilder;
includeBom: Boolean;

begin
success := False;

//  Demonstrates the Ftp2.PutFileSb method, which encodes the text in a StringBuilder and uploads
//  it to a remote path.  The 1st argument is the StringBuilder, the 2nd is the charset, the 3rd
//  selects whether a byte-order mark is included, and the 4th is the remote file path.

ftp := CkFtp2_Create();

CkFtp2_putHostname(ftp,'ftp.example.com');
CkFtp2_putUsername(ftp,'myFtpLogin');

//  Normally you would not hard-code the password in source.  You should instead obtain it
//  from an interactive prompt, environment variable, or a secrets vault.
CkFtp2_putPassword(ftp,'myPassword');

success := CkFtp2_Connect(ftp);
if (success = False) then
  begin
    Memo1.Lines.Add(CkFtp2__lastErrorText(ftp));
    Exit;
  end;

//  Build the text to upload.
sb := CkStringBuilder_Create();
CkStringBuilder_Append(sb,'name,quantity' + #10);
CkStringBuilder_Append(sb,'widgets,42' + #10);

//  Upload as UTF-8 without a byte-order mark.
includeBom := False;
success := CkFtp2_PutFileSb(ftp,sb,'utf-8',includeBom,'public_html/inventory.csv');
if (success = False) then
  begin
    Memo1.Lines.Add(CkFtp2__lastErrorText(ftp));
    Exit;
  end;
Memo1.Lines.Add('Uploaded text file.');

success := CkFtp2_Disconnect(ftp);
if (success = False) then
  begin
    Memo1.Lines.Add(CkFtp2__lastErrorText(ftp));
    Exit;
  end;

CkFtp2_Dispose(ftp);
CkStringBuilder_Dispose(sb);