PureBasic

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

Download Chilkat for PureBasic

PureBasic

IncludeFile "CkEmail.pb"

Procedure ChilkatExample()

    ;  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.i = CkEmail::ckCreate()
    If email.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkEmail::setCkSubject(email, "Monthly invoice #4432")
    CkEmail::setCkFrom(email, "billing@example.com")

    ;  Check whether the Subject header value matches a wildcard pattern (case-insensitive).
    match.i = CkEmail::ckHasHeaderMatching(email,"Subject","*invoice*",0)

    If match = 1
        Debug "The Subject header contains 'invoice'."
    Else
        Debug "The Subject header does not contain 'invoice'."
    EndIf



    CkEmail::ckDispose(email)


    ProcedureReturn
EndProcedure