Pascal (Lazarus/Delphi)
Pascal (Lazarus/Delphi)
Fetch a Single Message's MIME into a StringBuilder
See more IMAP Examples
Demonstrates the Chilkat Imap.FetchSingleAsMimeSb method, which downloads one message's MIME into a StringBuilder. The first argument is the message id, the second (bUid) selects UID vs sequence number, and the third is the StringBuilder, which is cleared first. This example downloads a message by UID and prints the MIME length.
Background: Chilkat interprets the received MIME as UTF-8. Messages using Base64 or quoted-printable transfer encoding are safe because their encoded bytes are ASCII. Raw
8bit or binary content, or unencoded text in a charset such as ISO-8859-1 or Shift_JIS, can be misinterpreted — in those cases use FetchSingleBd to get the exact bytes.Chilkat Pascal (Lazarus/Delphi) Downloads
program ChilkatDemo;
// Demonstrates using the Chilkat Pascal wrapper via the C bridge DLL.
// Builds as a console application under Lazarus (FPC) or Delphi.
{$IFDEF FPC}
{$MODE DELPHI}
{$ENDIF}
{$APPTYPE CONSOLE}
uses
{$IFDEF UNIX}
cthreads,
{$ENDIF}
SysUtils,
CkDllLoader,
Chilkat.StringBuilder,
Chilkat.Imap,
Chilkat.MessageSet;
// ---------------------------------------------------------------------------
procedure RunDemo;
var
success: Boolean;
imap: TImap;
wantUids: Boolean;
msgSet: TMessageSet;
uid: LongWord;
useUid: Boolean;
sbMime: TStringBuilder;
begin
success := False;
// Demonstrates the Imap.FetchSingleAsMimeSb method, which downloads one message's MIME into a
// StringBuilder. The 1st argument is the message id, the 2nd (bUid) selects UID vs sequence
// number, and the 3rd is the StringBuilder (cleared first).
imap := TImap.Create;
imap.Ssl := True;
imap.Port := 993;
success := imap.Connect('imap.example.com');
if (success = False) then
begin
WriteLn(imap.LastErrorText);
Exit;
end;
success := imap.Login('user@example.com','myPassword');
if (success = False) then
begin
WriteLn(imap.LastErrorText);
Exit;
end;
success := imap.SelectMailbox('Inbox');
if (success = False) then
begin
WriteLn(imap.LastErrorText);
Exit;
end;
// Search for the message ids to download, returning UIDs.
wantUids := True;
msgSet := TMessageSet.Create;
success := imap.QueryMbx('ALL',wantUids,msgSet);
if (success = False) then
begin
WriteLn(imap.LastErrorText);
Exit;
end;
if (msgSet.Count > 0) then
begin
uid := msgSet.GetId(0);
// Download the message's MIME into a StringBuilder. The id is a UID.
useUid := True;
sbMime := TStringBuilder.Create;
success := imap.FetchSingleAsMimeSb(uid,useUid,sbMime);
if (success = False) then
begin
WriteLn(imap.LastErrorText);
Exit;
end;
WriteLn('MIME length: ' + sbMime.Length + ' chars');
end;
success := imap.Disconnect();
if (success = False) then
begin
WriteLn(imap.LastErrorText);
Exit;
end;
imap.Free;
msgSet.Free;
sbMime.Free;
end;
// ---------------------------------------------------------------------------
begin
try
RunDemo;
except
on E: Exception do
WriteLn('Unhandled exception: ', E.ClassName, ': ', E.Message);
end;
WriteLn;
{$IFDEF MSWINDOWS}
WriteLn('Press Enter to exit...');
ReadLn;
{$ENDIF}
end.