Delphi DLL

Get a Mail-Merge Replacement String by Pattern

Demonstrates the Chilkat Email.GetReplaceString2 method, which returns the replacement string for a previously-defined pattern/replacement pair, looked up by the pattern itself (a mail-merge feature). This example defines two pairs and looks up the replacement for one pattern by name.

Background: Where GetReplaceString fetches a replacement by its numeric position, GetReplaceString2 fetches it by the pattern — convenient when you already know the token (say FIRST_NAME) and just want its configured substitution without scanning the whole list.

Chilkat Delphi DLL Downloads

Download Chilkat for Delphi DLL

Delphi DLL

var
email: HCkEmail;
repl: PWideChar;

begin
//  Demonstrates the GetReplaceString2 method, which returns the replacement string for a
//  previously-defined pattern/replacement pair, looked up by the pattern itself (a
//  mail-merge feature).

email := CkEmail_Create();
CkEmail_putSubject(email,'Hello FIRST_NAME');
CkEmail_putBody(email,'Dear FIRST_NAME, welcome to CITY.');

CkEmail_SetReplacePattern(email,'FIRST_NAME','John');
CkEmail_SetReplacePattern(email,'CITY','Denver');

//  Look up the replacement for a specific pattern.
repl := CkEmail__getReplaceString2(email,'FIRST_NAME');
Memo1.Lines.Add('FIRST_NAME -> ' + repl);

CkEmail_Dispose(email);