C++

Get a Digest Message as an Email Object

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++

C++

#include <CkEmail.h>

void ChilkatSample(void)
    {
    bool 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.

    CkEmail email;

    success = email.LoadEml("qa_data/eml/digest.eml");
    if (success == false) {
        std::cout << email.lastErrorText() << "\r\n";
        return true;
    }

    int n = email.get_NumDigests();
    std::cout << "NumDigests = " << n << "\r\n";

    //  Retrieve each bundled message as its own Email object.
    CkEmail digestEmail;
    int i;
    for (i = 0; i <= n - 1; i++) {
        success = email.GetDigestEmail(i,digestEmail);
        std::cout << "Digest " << i << " subject: " << digestEmail.subject() << "\r\n";
    }

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