Get a Mail-Merge Replacement String by Pattern

See more Email Object Examples

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

Download Chilkat for C

#include <C_CkEmail.h>

void ChilkatSample(void)
    {
    HCkEmail email;
    const char *repl;

    //  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");
    printf("FIRST_NAME -> %s\n",repl);


    CkEmail_Dispose(email);

    }