Get a Digest Message as an Email Object

See more Email Object Examples

Demonstrates the Chilkat Email.GetDigestEmail method, which copies the Nth digest email contained within a multipart/digest into another Email object. The first digest is at index 0; the NumDigests property gives the count. This example loads a digest email and lists each bundled message's subject.

Background: A multipart/digest packs many separate emails into one carrier message — historically used by mailing lists to send a single daily bundle of that day's posts. GetDigestEmail unpacks each member into a full Email object so it can be read or processed individually. This differs from GetAttachedEmail, which extracts messages attached to an ordinary email rather than the members of a digest.

Chilkat C Downloads

Download Chilkat for C

#include <C_CkEmail.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkEmail email;
    int n;
    HCkEmail digestEmail;
    int i;

    success = FALSE;

    //  Demonstrates the GetDigestEmail method, which copies the Nth digest email contained
    //  within a multipart/digest into another Email object.  The first digest is at index 0;
    //  use the NumDigests property for the count.

    email = CkEmail_Create();

    success = CkEmail_LoadEml(email,"qa_data/eml/digest.eml");
    if (success == FALSE) {
        printf("%s\n",CkEmail_lastErrorText(email));
        CkEmail_Dispose(email);
        return;
    }

    n = CkEmail_getNumDigests(email);
    printf("NumDigests = %d\n",n);

    //  Retrieve each bundled message as its own Email object.
    digestEmail = CkEmail_Create();

    for (i = 0; i <= n - 1; i++) {
        success = CkEmail_GetDigestEmail(email,i,digestEmail);
        printf("Digest %d subject: %s\n",i,CkEmail_subject(digestEmail));
    }

    //  Note: The path "qa_data/..." is a relative local filesystem path,
    //  relative to the current working directory of the running application.


    CkEmail_Dispose(email);
    CkEmail_Dispose(digestEmail);

    }