Unicode C

Get a Mail-Merge Replacement String by Index

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

Download Chilkat for Unicode C

Unicode C

#include <C_CkEmailW.h>

void ChilkatSample(void)
    {
    HCkEmailW email;
    int n;
    int i;

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

    email = CkEmailW_Create();
    CkEmailW_putSubject(email,L"Hello FIRST_NAME");
    CkEmailW_putBody(email,L"Dear FIRST_NAME, welcome to CITY.");

    CkEmailW_SetReplacePattern(email,L"FIRST_NAME",L"John");
    CkEmailW_SetReplacePattern(email,L"CITY",L"Denver");

    n = CkEmailW_getNumReplacePatterns(email);

    for (i = 0; i <= n - 1; i++) {
        wprintf(L"%s -> %s\n",CkEmailW_getReplacePattern(email,i),CkEmailW_getReplaceString(email,i));
    }



    CkEmailW_Dispose(email);

    }