JavaScript

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.

Note

This example is intended for running within a Chilkat.Js embedded JavaScript engine. All Chilkat JavaScript examples require Chilkat v11.4.0 or greater.

JavaScript

//  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).

var email = new CkEmail();
email.Subject = "Hello FIRST_NAME";
email.Body = "Dear FIRST_NAME, welcome to CITY.";

email.SetReplacePattern("FIRST_NAME","John");
email.SetReplacePattern("CITY","Denver");

//  Look up the replacement for a specific pattern.
var repl = email.GetReplaceString2("FIRST_NAME");
console.log("FIRST_NAME -> " + repl);