Xbase++

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

Download Chilkat for Xbase++

Xbase++

LOCAL nSuccess
LOCAL oEmail
LOCAL n
LOCAL oDigestEmail
LOCAL i

nSuccess := 0

//  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.

oEmail := CreateObject("Chilkat.Email")

nSuccess := oEmail:LoadEml("qa_data/eml/digest.eml")
IF (nSuccess == 0)
    ? oEmail:LastErrorText
    oEmail:destroy()
    RETURN
ENDIF

n := oEmail:NumDigests
? "NumDigests = " + Str(n)

//  Retrieve each bundled message as its own Email object.
oDigestEmail := CreateObject("Chilkat.Email")

FOR i := 0 TO n - 1
    nSuccess := oEmail:GetDigestEmail(i, oDigestEmail)
    ? "Digest " + Str(i) + " subject: " + oDigestEmail:Subject
NEXT

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

oEmail:destroy()
oDigestEmail:destroy()