(C++) Explaining the Email FromName, FromAddress, and From Properties

This example explains the email object's FromName, FromAddress, and From properties.

Chilkat C/C++ Library Downloads
MS Visual C/C++ Linux/CentOS C/C++ Alpine Linux C/C++ MAC OS X C/C++	armhf/aarch64 C/C++ C++ Builder iOS C/C++ Android C/C++	Solaris C/C++ MinGW C/C++

#include <CkEmail.h>

void ChilkatSample(void)
    {
    // The email's FROM name and address can be set in several ways.
    // It can include an optional friendly name (which is just a description),
    // and it must include an address.

    // For example:
    CkEmail email1;
    email1.put_Subject("test");
    email1.put_Body("test");

    email1.put_FromName("Joe Sample");
    email1.put_FromAddress("joe.sample@example.com");

    // the From property contains both the FromName and FromAddress
    // This produces the following output:
    // From: "Joe Sample" <joe.sample@example.com>
    std::cout << "From: " << email1.ck_from() << "\r\n";
    std::cout << "--------------------------------------------------" << "\r\n";

    // Examine the MIME of the email:
    std::cout << email1.getMime() << "\r\n";
    std::cout << "--------------------------------------------------" << "\r\n";

    // Output is:

    // 	MIME-Version: 1.0
    // 	Date: Wed, 16 Nov 2016 12:32:13 -0600
    // 	Message-ID: <02B461C6D12FA6686C3151A649ED8D5BBFBE0721@CHILKAT13>
    // 	Content-Type: text/plain
    // 	Content-Transfer-Encoding: 7bit
    // 	X-Priority: 3 (Normal)
    // 	Subject: test
    // 	From: "Joe Sample" <joe.sample@example.com>
    // 	CKX-Bounce-Address: joe.sample@example.com
    // 
    // 	test

    // --------------------------------------------
    // Alternatively, the From property can be set, and this 
    // implicitly sets the FromName and FromAddress properties.

    CkEmail email2;
    email2.put_From("Joe Sample <joe.sample@example.com>");

    std::cout << "FromName: " << email2.fromName() << "\r\n";
    std::cout << "FromAddress: " << email2.fromAddress() << "\r\n";
    std::cout << "--------------------------------------------------" << "\r\n";

    std::cout << email2.getMime() << "\r\n";
    }