AutoIt

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 AutoIt Downloads

Download Chilkat for AutoIt

AutoIt

;  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 = ObjCreate("Chilkat.Email")
$oEmail.Subject = "A message"
$oEmail.Body = "Some body text."
$oEmail.AddTo("Bob","bob@example.com")
$oEmail.AddStringAttachment("notes.txt","Some notes.")

ConsoleWrite("NumTo before clear = " & $oEmail.NumTo & @CRLF)
ConsoleWrite("NumAttachments before clear = " & $oEmail.NumAttachments & @CRLF)

;  Remove all content, resetting the email object.
$oEmail.Clear 

ConsoleWrite("NumTo after clear = " & $oEmail.NumTo & @CRLF)
ConsoleWrite("NumAttachments after clear = " & $oEmail.NumAttachments & @CRLF)