(PureBasic) Fetch Oldest/Newest IMAP Email

Emails may be downloaded by sequence number. Assuming the selected mailbox is not empty, the oldest email is at sequence number 1, and the newest email is at sequence number N. The FetchSingle method may be used to download by sequence number.

Chilkat PureBasic Module Download Chilkat PureBasic Module

IncludeFile "CkEmail.pb"
IncludeFile "CkImap.pb"

Procedure ChilkatExample()

    ; This example assumes the Chilkat API to have been previously unlocked.
    ; See Global Unlock Sample for sample code.

    imap.i = CkImap::ckCreate()
    If imap.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    ; Connect to an IMAP server.
    ; Use TLS
    CkImap::setCkSsl(imap, 1)
    CkImap::setCkPort(imap, 993)
    success.i = CkImap::ckConnect(imap,"mail.testemail.net")
    If success <> 1
        Debug CkImap::ckLastErrorText(imap)
        CkImap::ckDispose(imap)
        ProcedureReturn
    EndIf

    ; Login
    success = CkImap::ckLogin(imap,"***","***")
    If success <> 1
        Debug CkImap::ckLastErrorText(imap)
        CkImap::ckDispose(imap)
        ProcedureReturn
    EndIf

    ; Select an IMAP mailbox
    success = CkImap::ckSelectMailbox(imap,"Inbox")
    If success <> 1
        Debug CkImap::ckLastErrorText(imap)
        CkImap::ckDispose(imap)
        ProcedureReturn
    EndIf

    ; After selecting a mailbox, the NumMessages property
    ; contains the number of emails in the selected mailbox.
    n.i
    n = CkImap::ckNumMessages(imap)

    If n > 0

        ; The oldest email is always at sequence number 1.
        isUid.i = 0

        oldestEmail.i
        oldestEmail = CkImap::ckFetchSingle(imap,1,isUid)
        If CkImap::ckLastMethodSuccess(imap) = 1

            ; Display the From and Subject
            Debug CkEmail::ckFromAddress(oldestEmail)
            Debug CkEmail::ckSubject(oldestEmail)

            Debug "--"
            CkEmail::ckDispose(oldestEmail)

        EndIf

        ; The newest email is at sequence number N:
        newestEmail.i
        newestEmail = CkImap::ckFetchSingle(imap,n,isUid)
        If CkImap::ckLastMethodSuccess(imap) = 1

            ; Display the From and Subject
            Debug CkEmail::ckFromAddress(newestEmail)
            Debug CkEmail::ckSubject(newestEmail)

            CkEmail::ckDispose(newestEmail)

        EndIf

    EndIf

    ; Disconnect from the IMAP server.
    success = CkImap::ckDisconnect(imap)


    CkImap::ckDispose(imap)


    ProcedureReturn
EndProcedure