PureBasic

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 PureBasic Downloads

Download Chilkat for PureBasic

PureBasic

IncludeFile "CkEmail.pb"

Procedure ChilkatExample()

    success.i = 0

    ;  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.i = CkEmail::ckCreate()
    If email.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    ;  Load a multipart/digest email (a single email that bundles many messages).
    success = CkEmail::ckLoadEml(email,"qa_data/eml/digest.eml")
    If success = 0
        Debug CkEmail::ckLastErrorText(email)
        CkEmail::ckDispose(email)
        ProcedureReturn
    EndIf

    n.i = CkEmail::ckNumDigests(email)
    Debug "NumDigests = " + Str(n)

    ;  Retrieve each bundled message as its own Email object.
    digestEmail.i = CkEmail::ckCreate()
    If digestEmail.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    i.i
    For i = 0 To n - 1
        success = CkEmail::ckGetDigestEmail(email,i,digestEmail)
        Debug "Digest " + Str(i) + " subject: " + CkEmail::ckSubject(digestEmail)
    Next

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


    CkEmail::ckDispose(email)
    CkEmail::ckDispose(digestEmail)


    ProcedureReturn
EndProcedure