Unicode C

Test if an Email Header Matches a Pattern

Demonstrates the Chilkat Email.HasHeaderMatching method, which returns true when the email contains a header field named by the first argument whose value matches the wildcard pattern in the second argument. The third argument selects case-sensitive matching. This example checks whether the Subject contains the word "invoice".

Background: The value pattern supports wildcards — * matches any run of characters — so *invoice* matches any subject containing "invoice" anywhere. This is a compact way to classify or filter messages by header content, for example routing billing mail or flagging automated notices, without manually fetching the header value and testing it yourself.

Chilkat Unicode C Downloads

Download Chilkat for Unicode C

Unicode C

#include <C_CkEmailW.h>

void ChilkatSample(void)
    {
    HCkEmailW email;
    BOOL match;

    //  Demonstrates the HasHeaderMatching method, which returns true when the email contains a
    //  header field named by the first argument whose value matches the wildcard pattern in the second argument.  The third argument selects
    //  case-sensitive matching.

    email = CkEmailW_Create();
    CkEmailW_putSubject(email,L"Monthly invoice #4432");
    CkEmailW_putFrom(email,L"billing@example.com");

    //  Check whether the Subject header value matches a wildcard pattern (case-insensitive).
    match = CkEmailW_HasHeaderMatching(email,L"Subject",L"*invoice*",FALSE);

    if (match == TRUE) {
        wprintf(L"The Subject header contains 'invoice'.\n");
    }
    else {
        wprintf(L"The Subject header does not contain 'invoice'.\n");
    }



    CkEmailW_Dispose(email);

    }