Xbase++

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 Xbase++ Downloads

Download Chilkat for Xbase++

Xbase++

LOCAL oEmail

//  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.

oEmail := CreateObject("Chilkat.Email")
oEmail:Subject := "A message"
oEmail:Body := "Some body text."
oEmail:AddTo("Bob", "bob@example.com")
oEmail:AddStringAttachment("notes.txt", "Some notes.")

? "NumTo before clear = " + Str(oEmail:NumTo)
? "NumAttachments before clear = " + Str(oEmail:NumAttachments)

//  Remove all content, resetting the email object.
oEmail:Clear()

? "NumTo after clear = " + Str(oEmail:NumTo)
? "NumAttachments after clear = " + Str(oEmail:NumAttachments)

oEmail:destroy()