(Ruby) Transition from MailMan.FetchEmail to MailMan.FetchByUidl

Provides instructions for replacing deprecated FetchEmail method calls with FetchByUidl.

Note: This example requires Chilkat v11.0.0 or greater.

Chilkat Ruby Downloads install from rubygems.org gem install chilkat or download... Ruby Library for Windows, MacOS, Linux, Alpine Linux

require 'chilkat'

mailman = Chilkat::CkMailMan.new()

# ...
# ...

uidl = "123"

# ------------------------------------------------------------------------
# The FetchEmail method is deprecated:

# emailObj is a CkEmail
emailObj = mailman.FetchEmail(uidl)
if (mailman.get_LastMethodSuccess() == false)
    print mailman.lastErrorText() + "\n";
    exit
end

# ...
# ...

# ------------------------------------------------------------------------
# Do the equivalent using FetchByUidl.
# Your application creates a new, empty Email object which is passed 
# in the last argument and filled upon success.

headerOnly = false
# Irrelevant because we are not downloading headers-only.
numBodyLines = 0

emailOut = Chilkat::CkEmail.new()
success = mailman.FetchByUidl(uidl,headerOnly,numBodyLines,emailOut)
if (success == false)
    print mailman.lastErrorText() + "\n";
    exit
end