Unicode C
Unicode C
Search IMAP Mailbox for Email Matching Criteria
Searching an IMAP mailbox for messages that match search criteria.Chilkat Unicode C Downloads
#include <C_CkImapW.h>
#include <C_CkMessageSetW.h>
#include <C_CkEmailBundleW.h>
#include <C_CkEmailW.h>
void ChilkatSample(void)
{
BOOL success;
HCkImapW imap;
BOOL fetchUids;
const wchar_t *allMsgs;
const wchar_t *answered;
const wchar_t *onDate;
const wchar_t *betweenDates;
const wchar_t *complexSearch1;
const wchar_t *bodySearch;
const wchar_t *orSearch;
const wchar_t *fromSearch;
const wchar_t *johnSearch;
const wchar_t *recentSearch;
const wchar_t *notRecentSearch;
const wchar_t *oldSearch;
const wchar_t *markedForDeleteSearch;
const wchar_t *headerSearch;
const wchar_t *headerExistsSearch;
const wchar_t *newSearch;
const wchar_t *sizeLargerSearch;
const wchar_t *seenSearch;
const wchar_t *notSeenSearch;
const wchar_t *toSearch;
const wchar_t *toSearch2;
const wchar_t *smallerSearch;
const wchar_t *fullSubstringSearch;
HCkMessageSetW messageSet;
HCkEmailBundleW bundle;
BOOL headersOnly;
HCkEmailW email;
int i;
success = FALSE;
// This example requires the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.
imap = CkImapW_Create();
// Connect to an IMAP server.
// Use TLS
CkImapW_putSsl(imap,TRUE);
CkImapW_putPort(imap,993);
success = CkImapW_Connect(imap,L"imap.example.com");
if (success == FALSE) {
wprintf(L"%s\n",CkImapW_lastErrorText(imap));
CkImapW_Dispose(imap);
return;
}
// Login
success = CkImapW_Login(imap,L"myLogin",L"myPassword");
if (success == FALSE) {
wprintf(L"%s\n",CkImapW_lastErrorText(imap));
CkImapW_Dispose(imap);
return;
}
// Select an IMAP mailbox
success = CkImapW_SelectMailbox(imap,L"Inbox");
if (success == FALSE) {
wprintf(L"%s\n",CkImapW_lastErrorText(imap));
CkImapW_Dispose(imap);
return;
}
// We can choose to fetch UIDs or sequence numbers.
fetchUids = TRUE;
// Here are examples of different search criteria:
// Return all messages.
allMsgs = L"ALL";
// Search for already-answered emails.
answered = L"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.
onDate = L"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.
betweenDates = L"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:
complexSearch1 = L"UNANSWERED SENTSINCE 04-Mar-2007 Subject \"Problem\"";
// Find messages with a specific string in the body:
bodySearch = L"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:
orSearch = L"OR SUBJECT Help SUBJECT Question";
// ----------------------------------------------
// Strings are case-insensitive when searching....
// ----------------------------------------------
// Find all emails sent from yahoo.com addresses:
fromSearch = L"FROM yahoo.com";
// Find all emails sent from anyone with "John" in their name:
johnSearch = L"FROM John";
// Find emails with the RECENT flag set:
recentSearch = L"RECENT";
// Find emails that don't have the recent flag set:
notRecentSearch = L"NOT RECENT";
// This is synonymous with "OLD":
oldSearch = L"OLD";
// Find all emails marked for deletion:
markedForDeleteSearch = L"DELETED";
// Find all emails having a specified header field with a value
// containing a substring:
headerSearch = L"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:
headerExistsSearch = L"HEADER DomainKey-Signature \"\"";
// Find NEW emails: these are emails that have the RECENT flag
// set, but not the SEEN flag:
newSearch = L"NEW";
// Find emails larger than a certain number of bytes:
sizeLargerSearch = L"LARGER 500000";
// Find emails marked as seen or not already seen:
seenSearch = L"SEEN";
notSeenSearch = L"NOT SEEN";
// Find emails having a given substring in the TO header field:
toSearch = L"TO support@chilkatsoft.com";
// A more long-winded way to do the same thing:
toSearch2 = L"HEADER TO support@chilkatsoft.com";
// Find emails smaller than a size in bytes:
smallerSearch = L"SMALLER 30000";
// Find emails that have a substring anywhere in the header
// or body:
fullSubstringSearch = L"TEXT \"Zip Component\"";
// Pass any of the above strings here to test a search:
messageSet = CkMessageSetW_Create();
success = CkImapW_QueryMbx(imap,orSearch,fetchUids,messageSet);
if (success == FALSE) {
wprintf(L"%s\n",CkImapW_lastErrorText(imap));
CkImapW_Dispose(imap);
CkMessageSetW_Dispose(messageSet);
return;
}
// Fetch the email headers into a bundle object:
bundle = CkEmailBundleW_Create();
headersOnly = TRUE;
success = CkImapW_FetchMsgSet(imap,headersOnly,messageSet,bundle);
if (success == FALSE) {
wprintf(L"%s\n",CkImapW_lastErrorText(imap));
CkImapW_Dispose(imap);
CkMessageSetW_Dispose(messageSet);
CkEmailBundleW_Dispose(bundle);
return;
}
// Display the Subject and From of each email.
email = CkEmailW_Create();
i = 0;
while (i < CkEmailBundleW_getMessageCount(bundle)) {
CkEmailBundleW_EmailAt(bundle,i,email);
wprintf(L"%s\n",CkEmailW_getHeaderField(email,L"Date"));
wprintf(L"%s\n",CkEmailW_subject(email));
wprintf(L"%s\n",CkEmailW_ck_from(email));
wprintf(L"--\n");
i = i + 1;
}
// Disconnect from the IMAP server.
success = CkImapW_Disconnect(imap);
CkImapW_Dispose(imap);
CkMessageSetW_Dispose(messageSet);
CkEmailBundleW_Dispose(bundle);
CkEmailW_Dispose(email);
}