Dart

Get a Mail-Merge Replace Pattern

Demonstrates the Chilkat Email.GetReplacePattern method, which returns a replacement pattern — the search string — previously defined for mail-merge operations with SetReplacePattern. The index is zero-based. This example defines two patterns and enumerates them.

Background: In Chilkat's mail-merge, each entry is a pattern (a placeholder token such as FIRST_NAME) paired with a replacement string. GetReplacePattern retrieves the search side of the pair at a given index; GetReplaceString retrieves the matching replacement. Reading them back is useful for inspecting or logging exactly which substitutions will be applied when the message is sent.

Chilkat Dart Downloads

Download Chilkat for Dart

Dart

import 'package:chilkat/chilkat.dart';

void main() {
  // Demonstrates the GetReplacePattern method, which returns a replacement pattern (the
  // search string) previously defined for mail-merge operations with SetReplacePattern.
  // The index is zero-based.

  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('Pattern $i: ${email.getReplacePattern(i)}');
  }
}