Dart

Append Text Content to a Remote FTP File

Demonstrates the Chilkat Ftp2.AppendFileFromTextData method, which appends text (encoded with a charset) to a remote file. The arguments are the remote filename, the text, and the charset.

Background: This is the append equivalent of PutFileFromTextData — the simplest way to add a line or record to a remote log or data file directly from a string, with no local file involved. The charset controls the encoding of the appended content; the remote filename's own encoding is handled separately.

Chilkat Dart Downloads

Download Chilkat for Dart

Dart

import 'package:chilkat/chilkat.dart';

void main() {
  // Demonstrates the Ftp2.AppendFileFromTextData method, which appends text (encoded with a
  // charset) to a remote file.  The 1st argument is the remote filename, the 2nd is the text, and
  // the 3rd is the charset.

  final ftp = CkFtp2();

  ftp.hostname = 'ftp.example.com';
  ftp.username = '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.
  ftp.password = 'myPassword';

  try {
    ftp.connect();
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  // Append a log line directly, with no local file involved.
  final line = '2026-07-27 12:00:00  server started\n';
  try {
    ftp.appendFileFromTextData('logs/app.log', line, 'utf-8');
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  print('Appended a log line.');

  try {
    ftp.disconnect();
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }
}