Get MessageSet IDs as a Compact String

See more IMAP Examples

Demonstrates the Chilkat MessageSet.ToCompactString method, which returns the unique identifiers in ascending order using compact IMAP message-set syntax, collapsing consecutive runs into inclusive ranges. It takes no arguments. This example loads 1,2,3,4,5,8,9,10 and prints the compact form 1:5,8:10.

Background: The result is canonical for the current set — unique, sorted, and range-compacted — which is the compact notation IMAP servers expect for message-set arguments. It is the inverse of FromCompactString, so the two round-trip: a set emitted here can be reloaded later. The string contains only numbers and omits the HasUids setting, so track UID-vs-sequence separately.

Chilkat C Downloads

Download Chilkat for C

#include <C_CkMessageSet.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkMessageSet msgSet;
    const char *compact;

    success = FALSE;

    //  Demonstrates the MessageSet.ToCompactString method, which returns the unique identifiers in
    //  ascending order using compact IMAP message-set syntax, with consecutive runs collapsed into
    //  inclusive ranges.  It takes no arguments.

    msgSet = CkMessageSet_Create();

    //  Load a set of individual identifiers.
    success = CkMessageSet_FromCompactString(msgSet,"1,2,3,4,5,8,9,10");
    if (success == FALSE) {
        printf("%s\n",CkMessageSet_lastErrorText(msgSet));
        CkMessageSet_Dispose(msgSet);
        return;
    }

    //  Get the canonical compact representation.
    compact = CkMessageSet_toCompactString(msgSet);
    printf("%s\n",compact);
    //  Output: 1:5,8:10


    CkMessageSet_Dispose(msgSet);

    }