C++

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

Download Chilkat for C++

C++

#include <CkEmail.h>

void ChilkatSample(void)
    {
    //  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.

    CkEmail email;
    email.put_Subject("A message");
    email.put_Body("Some body text.");
    email.AddTo("Bob","bob@example.com");
    email.AddStringAttachment("notes.txt","Some notes.");

    std::cout << "NumTo before clear = " << email.get_NumTo() << "\r\n";
    std::cout << "NumAttachments before clear = " << email.get_NumAttachments() << "\r\n";

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

    std::cout << "NumTo after clear = " << email.get_NumTo() << "\r\n";
    std::cout << "NumAttachments after clear = " << email.get_NumAttachments() << "\r\n";
    }