Delphi DLL

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 Delphi DLL Downloads

Download Chilkat for Delphi DLL

Delphi DLL

var
success: Boolean;
email: HCkEmail;
n: Integer;
digestEmail: HCkEmail;
i: Integer;

begin
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) then
  begin
    Memo1.Lines.Add(CkEmail__lastErrorText(email));
    Exit;
  end;

n := CkEmail_getNumDigests(email);
Memo1.Lines.Add('NumDigests = ' + IntToStr(n));

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

for i := 0 to n - 1 do
  begin
    success := CkEmail_GetDigestEmail(email,i,digestEmail);
    Memo1.Lines.Add('Digest ' + IntToStr(i) + ' subject: ' + CkEmail__subject(digestEmail));
  end;

//  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);