Unicode C

Count the Messages in a multipart/digest Email

Demonstrates the read-only Chilkat Email.NumDigests property, which is the number of message/rfc822 parts contained within a multipart/digest enclosure. If no such enclosure exists, the value is 0. Digest indexes are zero-based; use GetDigestEmail to retrieve an individual bundled message as its own Email object. This example loads a digest email and lists each message's subject.

Background: A multipart/digest is a way to package many separate emails inside one carrier message — historically used by mailing lists to send a single daily "digest" containing all of that day's posts. Each bundled item is a complete message/rfc822 email with its own headers and body. This differs from NumAttachedMessages, which counts nested messages attached to an ordinary email rather than the members of a digest enclosure.

Chilkat Unicode C Downloads

Download Chilkat for Unicode C

Unicode C

#include <C_CkEmailW.h>

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

    success = FALSE;

    //  Demonstrates the read-only Email.NumDigests property, which is the number of
    //  message/rfc822 parts contained within a multipart/digest enclosure.  If there is no
    //  multipart/digest enclosure, the value is 0.  Digest indexes are zero-based.

    email = CkEmailW_Create();

    //  Load a multipart/digest email (a single email that bundles many messages).
    success = CkEmailW_LoadEml(email,L"qa_data/eml/digest.eml");
    if (success == FALSE) {
        wprintf(L"%s\n",CkEmailW_lastErrorText(email));
        CkEmailW_Dispose(email);
        return true;
    }

    n = CkEmailW_getNumDigests(email);
    wprintf(L"NumDigests = %d\n",n);

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

    for (i = 0; i <= n - 1; i++) {
        success = CkEmailW_GetDigestEmail(email,i,digestEmail);
        wprintf(L"Digest %d subject: %s\n",i,CkEmailW_subject(digestEmail));
    }

    //  Note: Paths such as "qa_data/..." are relative local filesystem paths,
    //  relative to the current working directory of the running application.


    CkEmailW_Dispose(email);
    CkEmailW_Dispose(digestEmail);

    }