Chilkat HOME ASP Visual Basic VB.NET C# Visual C++ C MFC Delphi FoxPro Java Perl PHP Python Ruby SQL Server VBScript
|
Search IMAP Mailbox for Email Matching CriteriaSearching an IMAP mailbox for messages that match search criteria.
#include <CkImap.h> #include <CkMessageSet.h> #include <CkString.h> #include <CkEmailBundle.h> #include <CkEmail.h> void ChilkatSample(void) { CkImap imap; bool success; // Anything unlocks the component and begins a fully-functional 30-day trial. success = imap.UnlockComponent("Anything for 30-day trial"); if (success != true) { printf("%s\n",imap.lastErrorText()); return; } // Connect to an IMAP server. success = imap.Connect("mail.chilkatsoft.com"); if (success != true) { printf("%s\n",imap.lastErrorText()); return; } // Login success = imap.Login("admin@chilkatsoft.com","*myPassword5*"); if (success != true) { printf("%s\n",imap.lastErrorText()); return; } // Select an IMAP mailbox success = imap.SelectMailbox("Inbox"); if (success != true) { printf("%s\n",imap.lastErrorText()); return; } CkMessageSet *messageSet = 0; // We can choose to fetch UIDs or sequence numbers. bool fetchUids; fetchUids = true; // Here are examples of different search criteria: // Return all messages. CkString allMsgs; allMsgs = "ALL"; // Search for already-answered emails. CkString answered; answered = "ANSWERED"; // Search for messages on a specific date. // The date string is DD-Month-YYYY where Month is // Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, or Dec. CkString onDate; onDate = "SENTON 05-Mar-2007"; // Search for messages between two dates. SENTBEFORE // finds emails sent before a date, and SENTSINCE finds // email sent on or after a date. The "AND" operation // is implied by joining criteria, separated by spaces. CkString betweenDates; betweenDates = "SENTSINCE 01-Mar-2007 SENTBEFORE 05-Mar-2007"; // Another example of AND: find all unanswered emails // sent after 04-Mar-2007 with "Problem" in the subject: CkString complexSearch1; complexSearch1 = "UNANSWERED SENTSINCE 04-Mar-2007 Subject \"Problem\""; // Find messages with a specific string in the body: CkString bodySearch; bodySearch = "BODY \"problem solved\""; // Using OR. The syntax is OR <criteria1> <criteria2>. // The "OR" comes first, followed by each criteria. // For example, to match all emails with "Help" or "Question" in the subject. // You'll notice that literal strings may be quoted or unquoted. // If a literal contains SPACE characters, quote it: CkString orSearch; orSearch = "OR SUBJECT Help SUBJECT Question"; // ---------------------------------------------- // Strings are case-insensitive when searching.... // ---------------------------------------------- // Find all emails sent from yahoo.com addresses: CkString fromSearch; fromSearch = "FROM yahoo.com"; // Find all emails sent from anyone with "John" in their name: CkString johnSearch; johnSearch = "FROM John"; // Find emails with the RECENT flag set: CkString recentSearch; recentSearch = "RECENT"; // Find emails that don't have the recent flag set: CkString notRecentSearch; notRecentSearch = "NOT RECENT"; // This is synonymous with "OLD": CkString oldSearch; oldSearch = "OLD"; // Find all emails marked for deletion: CkString markedForDeleteSearch; markedForDeleteSearch = "DELETED"; // Find all emails having a specified header field with a value // containing a substring: CkString headerSearch; headerSearch = "HEADER DomainKey-Signature paypal.com"; // Find any emails having a specific header field. If the // 2nd argument to the "HEADER" criteria is an empty string, // any email having the header field is returned regardless // of the header field's content. // Find any emails with a DomainKey-Signature field: CkString headerExistsSearch; headerExistsSearch = "HEADER DomainKey-Signature \"\""; // Find NEW emails: these are emails that have the RECENT flag // set, but not the SEEN flag: CkString newSearch; newSearch = "NEW"; // Find emails larger than a certain number of bytes: CkString sizeLargerSearch; sizeLargerSearch = "LARGER 500000"; // Find emails marked as seen or not already seen: CkString seenSearch; seenSearch = "SEEN"; CkString notSeenSearch; notSeenSearch = "NOT SEEN"; // Find emails having a given substring in the TO header field: CkString toSearch; toSearch = "TO support@chilkatsoft.com"; // A more long-winded way to do the same thing: CkString toSearch2; toSearch2 = "HEADER TO support@chilkatsoft.com"; // Find emails smaller than a size in bytes: CkString smallerSearch; smallerSearch = "SMALLER 30000"; // Find emails that have a substring anywhere in the header // or body: CkString fullSubstringSearch; fullSubstringSearch = "TEXT \"Zip Component\""; // Pass any of the above strings here to test a search: messageSet = imap.Search(orSearch,fetchUids); if (messageSet == 0 ) { printf("%s\n",imap.lastErrorText()); return; } // Fetch the email headers into a bundle object: CkEmailBundle *bundle = 0; bundle = imap.FetchHeaders(*messageSet); if (bundle == 0 ) { delete messageSet; printf("%s\n",imap.lastErrorText()); return; } // Display the Subject and From of each email. int i; for (i = 0; i <= bundle->get_MessageCount() - 1; i++) { CkEmail *email = 0; email = bundle->GetEmail(i); printf("%s\n",email->getHeaderField("Date")); printf("%s\n",email->subject()); printf("%s\n",email->ck_from()); printf("--\n"); delete email; } // Disconnect from the IMAP server. imap.Disconnect(); delete messageSet; delete bundle; } |
Need a specific example? Send a request to support@chilkatsoft.com
© 2000-2008 Chilkat Software, Inc. All Rights Reserved.