Unicode C

IMAP Search with THREAD Semantics

See more IMAP Examples

Demonstrates how to search an IMAP mailbox and return message numbers grouped together in parent/child relationships based on which messages are replies to others. Unicode C

#include <C_CkImapW.h>
#include <C_CkJsonObjectW.h>
#include <C_CkJsonArrayW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkImapW imap;
    HCkJsonObjectW json;
    int numThreads;
    HCkJsonArrayW arr;
    int threadSize;
    int i;
    HCkJsonArrayW subArr;

    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 your IMAP server and authenticate..
    CkImapW_putSsl(imap,TRUE);
    CkImapW_putPort(imap,993);
    success = CkImapW_Connect(imap,L"imap.mail.us-west-2.awsapps.com");
    if (success == FALSE) {
        wprintf(L"%s\n",CkImapW_lastErrorText(imap));
        CkImapW_Dispose(imap);
        return;
    }

    success = CkImapW_Login(imap,L"myLogin",L"myPassword");
    if (success == FALSE) {
        wprintf(L"%s\n",CkImapW_lastErrorText(imap));
        CkImapW_Dispose(imap);
        return;
    }

    //  Select a mailbox
    success = CkImapW_SelectMailbox(imap,L"Inbox");
    if (success == FALSE) {
        wprintf(L"%s\n",CkImapW_lastErrorText(imap));
        CkImapW_Dispose(imap);
        return;
    }

    //  Search for all message having the letter 'a' somewhere in the Subject,
    //  and return the messages as JSON.
    json = CkJsonObjectW_Create();
    success = CkImapW_QueryThread(imap,L"REFERENCES",L"SUBJECT a",TRUE,json);
    if (success == FALSE) {
        wprintf(L"%s\n",CkImapW_lastErrorText(imap));
        CkImapW_Dispose(imap);
        CkJsonObjectW_Dispose(json);
        return;
    }

    //  The IMAP server will return a raw response with a format such as this:  (2)(3 6 (4 23)(44 7 96))

    //  In tree form, it's like this:
    //  
    //              -- 2
    //              -- 3
    //                  \-- 6
    //                     |-- 4
    //                     |      \-- 23
    //                     |
    //                     |-- 44
    //                                \-- 7
    //                                        \-- 96
    //  

    //  It means there are 2 main threads returned, but the 2nd thread splits into two sub-threads.
    //  In total, we can think of it as 3 threads -- 2 main threads (with no parents) and one sub-thread w/ a parent.
    //  
    //  - The 1st thread contains the message 2, and has no parent thread.
    //  - The 2nd thread contains the messages 3, 6, 4, 23, and has no parent thread.
    //  - The 3rd thread contains the messages 44, 7, 96 and the parent thread is message 6.
    //  

    //  (Yes, this is all highly confusing...)

    //  Chilkat will return the above sample response as JSON that looks like this:

    //  {
    //    "threads": [
    //      [2],
    //      [3, 6, [4, 23], [44, 7, 96]]
    //    ]
    //  }
    //  

    //  Use this online tool to generate parsing code from sample JSON: 
    //  Generate Parsing Code from JSON
    //  In this case, the online tool can help you get a feel for how to write the JSON parsing code..

    numThreads = CkJsonObjectW_SizeOfArray(json,L"threads");
    wprintf(L"The total number of top-level threads is %d\n",numThreads);

    //  Let's say we wanted to get the messages in the thread 3, 6, 4, 23.
    //  We always follow the 1st branch to the bottom, ignoring the other branches.
    //  For example, if we had  [3, 5, [4, 23, [55, 56, 57], [68, 69]], [44, 7, 96]]
    //  then the thread would be 3, 5, 4, 43, 55, 56, 57

    //  For testing, let's substitute the response from the IMAP server with this sample:
    CkJsonObjectW_Load(json,L"{\"threads\": [[2], [3, 5, [4, 23, [55, 56, 57], [68, 69]], [44, 7, 96]]]}");

    //  Begin with the 2nd top-level thread, which is at index 1.
    wprintf(L"Following the 2nd top level thread...\n");
    arr = CkJsonObjectW_ArrayOf(json,L"threads[1]");
    threadSize = CkJsonArrayW_getSize(arr);
    i = 0;
    while (i < threadSize) {
        //  Do we have an array or integer at this position?
        if (CkJsonArrayW_TypeAt(arr,i) == 4) {
            //  This is a sub-array.
            subArr = CkJsonArrayW_ArrayAt(arr,i);
            CkJsonArrayW_Dispose(arr);
            //  Follow the sub-array starting at the 1st position..
            arr = subArr;
            i = 0;
            threadSize = CkJsonArrayW_getSize(arr);
        }
        else {
            //  Must be a single integer.
            wprintf(L"%d\n",CkJsonArrayW_IntAt(arr,i));
            i = i + 1;
        }

    }

    //  The output is:
    //  
    //  Following the 2nd top level thread...
    //  3
    //  5
    //  4
    //  23
    //  55
    //  56
    //  57


    CkImapW_Dispose(imap);
    CkJsonObjectW_Dispose(json);

    }