Dart

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 Dart Downloads

Download Chilkat for Dart

Dart

import 'package:chilkat/chilkat.dart';

void main() {
  // 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.

  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;
  }

  // Build the text to upload.
  final sb = CkStringBuilder();
  sb.append('name,quantity\n');
  sb.append('widgets,42\n');

  // Upload as UTF-8 without a byte-order mark.
  final includeBom = false;
  try {
    ftp.putFileSb(sb, 'utf-8', includeBom, 'public_html/inventory.csv');
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  print('Uploaded text file.');

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