(Go) Read IMAP Email Headers

Call FetchHeaders to download only the email headers.

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

Chilkat Go Downloads Go Package for Windows, MacOS, Linux, Alpine Linux, Solaris

    success := false

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

    imap := Imap_Ref.html">chilkat.NewImap()

    // Connect to an IMAP server.
    // Use TLS
    imap.SetSsl(true)
    imap.SetPort(993)
    success = imap.Connect("imap.example.com")
    if success == false {
        fmt.Println(imap.LastErrorText())
        imap.DisposeImap()
        return
    }

    // Login
    success = imap.Login("****","****")
    if success == false {
        fmt.Println(imap.LastErrorText())
        imap.DisposeImap()
        return
    }

    // Select an IMAP mailbox
    success = imap.SelectMailbox("Inbox")
    if success == false {
        fmt.Println(imap.LastErrorText())
        imap.DisposeImap()
        return
    }

    // Get the message IDs of all the emails in the mailbox
    // We can choose to fetch UIDs or sequence numbers.
    fetchUids := true
    messageSet := MessageSet_Ref.html">chilkat.NewMessageSet()
    success = imap.QueryMbx("ALL",fetchUids,messageSet)
    if success == false {
        fmt.Println(imap.LastErrorText())
        imap.DisposeImap()
        messageSet.DisposeMessageSet()
        return
    }

    // When downloading headers, each email object contains
    // (obviously) the headers, but the body will be missing.
    // Also, attachments will not be included.  However, it is
    // possible to get information about the attachments
    // as well as the complete size of the email.
    bundle := EmailBundle_Ref.html">chilkat.NewEmailBundle()
    headersOnly := true
    success = imap.FetchMsgSet(headersOnly,messageSet,bundle)
    if success == false {
        fmt.Println(imap.LastErrorText())
        imap.DisposeImap()
        messageSet.DisposeMessageSet()
        bundle.DisposeEmailBundle()
        return
    }

    // Loop over the email objects and display information
    // about each:
    email := Email_Ref.html">chilkat.NewEmail()
    var name string
    var addr string
    i := 0
    j := 0
    for i < bundle.MessageCount() {
        bundle.EmailAt(i,email)

        // Display the From and Subject
        fmt.Println(email.From())
        fmt.Println(email.Subject())

        // Display the recipients:
        j = 0
        for j < email.NumTo() {
            fmt.Println("TO: ", *email.GetToName(j), ", ", *email.GetToAddr(j))
            j = j + 1
        }

        j = 0
        for j < email.NumCC() {
            fmt.Println("CC: ", *email.GetCcName(j), ", ", *email.GetCcAddr(j))
            j = j + 1
        }

        // Show the total size of the email, including body and attachments:
        fmt.Println(email.Size())

        // When a full email is downloaded, we would use the
        // email.NumAttachments property in conjunction with the
        // email.GetMailAttach* methods.
        // However, when an email object contains only the header,
        // we need to access the attachment info differently:
        numAttach := imap.GetMailNumAttach(email)
        j = 0
        for j < numAttach {
            fmt.Println(*imap.GetMailAttachFilename(email,j))
            attachSize := imap.GetMailAttachSize(email,j)
            fmt.Println("    size = ", attachSize, " bytes")
            j = j + 1
        }

        fmt.Println("--")
    }

    // Disconnect from the IMAP server.
    success = imap.Disconnect()

    imap.DisposeImap()
    messageSet.DisposeMessageSet()
    bundle.DisposeEmailBundle()
    email.DisposeEmail()