Sample code for 30+ languages & platforms
Dart

Get a Mail-Merge Replacement String by Index

See more Email Object Examples

Demonstrates the Chilkat Email.GetReplaceString method, which returns the replacement string for the Nth previously-defined pattern/replacement pair (a mail-merge feature). The index is zero-based and corresponds to the same index used by GetReplacePattern. This example defines two pairs and prints each pattern with its replacement.

Background: Pairing GetReplacePattern (the token to find) with GetReplaceString (the text to substitute) at the same index lets you walk the full mail-merge table. Retrieving a replacement by its position is handy when enumerating all substitutions; to look one up by its pattern instead, use GetReplaceString2.

Chilkat Dart Downloads

Dart
import 'package:chilkat/chilkat.dart';

void main() {
  // Demonstrates the GetReplaceString method, which returns the replacement string for the
  // Nth previously-defined pattern/replacement pair (a mail-merge feature).  The index is
  // zero-based and corresponds to the same index used by GetReplacePattern.

  final email = CkEmail();
  email.subject = 'Hello FIRST_NAME';
  email.body = 'Dear FIRST_NAME, welcome to CITY.';

  email.setReplacePattern('FIRST_NAME', 'John');
  email.setReplacePattern('CITY', 'Denver');

  final n = email.numReplacePatterns;
  for (var i = 0; i < n; i++) {
    print('${email.getReplacePattern(i)} -> ${email.getReplaceString(i)}');
  }
}