DOWNLOAD • Reference • Chilkat Log Reference • Versions

Mail Filtering Capabilities

The ChilkatMailMan object has a new property named Filter which allows an application to filter messages based on header and/or body content. The Filter property is a string expression that evaluates to TRUE or FALSE. Here are a couple examples:

1. body contains "college football" and subject = "weekend scores"
2. subject like "ADV:*" and not (to contains "fausey@chilkatsoft.com")
3. from like "Intel Developer*"

When the Filter property is present, it is applied to any of the following method calls: LoadXmlFile, LoadXmlString, LoadOutlookFolder, LoadMbx, CopyMail, and TransferMail. Only the emails that match the filter's expression are returned in the email bundle. In the case of TransferMail, only the matching emails are removed from the mail server.

Here are the general rules for forming filter expressions:

• Any MIME header field name can be used, case is insensitive.
• Literal strings are double-quoted, and case is insensitive.
• The "*" wildcard matches 0 or more occurances of any character.
• Parentheses can be used to control precedence.
• The logical operators are: AND, OR, NOT (case insensitive)
• Comparison operators are: =, <, >, <=, >=, <>
• String comparison operators are: CONTAINS, LIKE (case insensitive)