Fetch a Set of POP3 Messages by UIDL

See more POP3 Examples

Demonstrates the Chilkat MailMan.FetchUidlSet method, which retrieves the messages whose UIDLs are listed in a StringTable and appends them to an EmailBundle. The arguments are the UIDL StringTable, headersOnly, numBodyLines, and the EmailBundle. This example fetches two specific messages by UIDL.

func chilkatTest() {
    var success: Bool = false

    //  Demonstrates the MailMan.FetchUidlSet method, which retrieves the messages whose UIDLs are
    //  listed in a StringTable and appends them to an EmailBundle.  The arguments are the UIDL
    //  StringTable, headersOnly, numBodyLines, and the EmailBundle.  The messages remain on the
    //  server.

    let mailman = CkoMailMan()!

    //  Configure the POP3 server connection.
    mailman.mailHost = "pop.example.com"
    mailman.mailPort = 995
    mailman.popSsl = true
    mailman.popUsername = "user@example.com"
    mailman.popPassword = "myPassword"

    //  Build the set of UIDLs to fetch.
    let uidls = CkoStringTable()!
    uidls.append(value: "0000000123abcdef")
    uidls.append(value: "0000000124abcdef")

    //  Fetch the listed messages (full bodies) into a bundle.
    //  headersOnly=false (fetch the entire message).
    //  Note: numBodyLines only applies when headersOnly is true (it sets how many lines of the
    //  body to include along with the headers).  When headersOnly is false, the entire message
    //  is fetched and numBodyLines is ignored.
    let bundle = CkoEmailBundle()!

    success = mailman.fetchUidlSet(uidls: uidls, headersOnly: false, numBodyLines: 0, bundle: bundle)
    if success == false {
        print("\(mailman.lastErrorText!)")
        return
    }

    var n: Int = bundle.messageCount.intValue
    print("Fetched \(n) messages.")

    let email = CkoEmail()!
    var i: Int
    for i = 0; i <= n - 1; i++ {
        success = bundle.email(at: i, email: email)
        print("\(email.subject!)")
    }

    //  Note: Explicitly connecting/authenticating is optional.  Chilkat MailMan automatically
    //  connects and authenticates -- using the property settings above -- whenever a server
    //  operation requires it.  Calling the explicit connect/authenticate methods can still be
    //  helpful to determine whether a failure occurs while connecting or while authenticating.

}