Swift

Clear an Email Object

Demonstrates the Chilkat Email.Clear method, which removes the current message content — recipients, headers, body representations, attachments, related items, and embedded messages — leaving an empty email object. This example builds a message with a recipient and attachment, clears it, and prints the counts before and after.

Background: Reusing a single Email object across many operations is efficient, but leftover state from a previous message could leak into the next. Clear resets the object completely, giving you a clean slate — the safe way to start a fresh message without allocating a new object.

Chilkat Swift Downloads

Download Chilkat for Swift

Swift


func chilkatTest() {
    //  Demonstrates the Clear method, which removes the current message content, including
    //  recipients, headers, body representations, attachments, related items, and embedded
    //  messages -- leaving an empty email object.

    let email = CkoEmail()!
    email.subject = "A message"
    email.body = "Some body text."
    email.add(to: "Bob", emailAddress: "bob@example.com")
    email.addStringAttachment(fileName: "notes.txt", str: "Some notes.")

    print("NumTo before clear = \(email.numTo.intValue)")
    print("NumAttachments before clear = \(email.numAttachments.intValue)")

    //  Remove all content, resetting the email object.
    email.clear()

    print("NumTo after clear = \(email.numTo.intValue)")
    print("NumAttachments after clear = \(email.numAttachments.intValue)")

}