(Unicode C) Create Binary MIME

Demonstrates how to create and save a multipart/mixed MIME document where the parts (a JPG and a PDF) are NOT base64 encoded, but are instead binary.

Note: This example requires Chilkat v9.5.0.62 or greater.

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 <C_CkMimeW.h>
#include <C_CkBinDataW.h>
#include <C_CkEmailW.h>
#include <C_CkStringBuilderW.h>

void ChilkatSample(void)
    {
    HCkMimeW mime;
    BOOL success;
    HCkMimeW jpgPart;
    HCkMimeW pdfPart;
    HCkBinDataW binData;
    HCkEmailW email;
    HCkStringBuilderW sb;

    // This example requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    mime = CkMimeW_Create();

    CkMimeW_SetBodyFromPlainText(mime,L"This is the plain text body.");
    CkMimeW_ConvertToMultipartMixed(mime);
    CkMimeW_AppendPartFromFile(mime,L"qa_data/jpg/penguins.jpg");
    CkMimeW_AppendPartFromFile(mime,L"qa_data/pdf/fishing.pdf");

    // At this point, when saved, the MIME bodies will be base64 encoded.
    CkMimeW_SaveMime(mime,L"qa_output/sample.txt");

    // We now have the following MIME where everything is base64 encoded:
    // The code that follows shows how to eliminate the base64 to make this binary MIME.

    // 	Content-Type: multipart/mixed; boundary="------------000207060703080505060404"
    // 
    // 	--------------000207060703080505060404
    // 	Content-Type: text/plain
    // 	Content-Transfer-Encoding: 7bit
    // 
    // 	This is the plain text body.
    // 	--------------000207060703080505060404
    // 	Content-Disposition: attachment; filename="penguins.jpg"
    // 	Content-Type: image/jpeg; name="penguins.jpg"
    // 	Content-Transfer-Encoding: base64
    // 
    // 	/9j/4AAQSkZJRgABAgEAYABgAAD/7gAOQWRvYmUAZAAAAAAB/+ESCEV4aWYAAE1NACoAAAAIAAcB
    // 	MgACAAAAFAAAAGIBOwACAAAABwAAAHZHRgADAAAAAQAEAABHSQADAAAAAQA/AACcnQABAAAADgAA
    // 	...
    // 	800a1MlLipJHlyU9en7sqVPkBK+gBj+o+1E91Ld7iJk0pJDO5PmDk4FOGOHy6S3JW120W1uCJ5M0
    // 	PBa54edOFAc8ePX/2Q==
    // 
    // 	--------------000207060703080505060404
    // 	Content-Disposition: attachment; filename="fishing.pdf"
    // 	Content-Type: application/pdf; name="fishing.pdf"
    // 	Content-Transfer-Encoding: base64
    // 
    // 	JVBERi0xLjMKJcfsj6IKNSAwIG9iago8PC9MZW5ndGggNiAwIFIvRmlsdGVyIC9GbGF0ZURlY29k
    // 	ZT4+CnN0cmVhbQp4nM1c288cNxVX09A0myq35tom7bSl8E1hp76P/YpASIiXlEg8tDwVKEJfilIe
    // 	...
    // 	MDRGMT48OTlENkRFQzExQjkzNjA0Mjc1RUFCNzIyMjI4RjA0RjE+XQo+PgpzdGFydHhyZWYKMjk0
    // 	MzY5CiUlRU9GCg==
    // 
    // 	--------------000207060703080505060404--
    // 

    // To make it binary MIME (getting rid of the base64), set the Encoding property to "binary"
    // for the JPG and PDF parts.
    jpgPart = CkMimeW_GetPart(mime,1);
    CkMimeW_putEncoding(jpgPart,L"binary");
    CkMimeW_Dispose(jpgPart);

    pdfPart = CkMimeW_GetPart(mime,2);
    CkMimeW_putEncoding(pdfPart,L"binary");
    CkMimeW_Dispose(pdfPart);

    // Now save it.  If you try to view this MIME in a text editor,
    // the JPG and PDF parts will be garbled and unintelligible. That's because
    // the bytes do not represent characters.
    CkMimeW_SaveMime(mime,L"qa_output/sampleBinary.mim");

    // The MIME now contains this:

    // 	Content-Type: multipart/mixed; boundary="------------000207060703080505060404"
    // 
    // 	--------------000207060703080505060404
    // 	Content-Type: text/plain
    // 	Content-Transfer-Encoding: 7bit
    // 
    // 	This is the plain text body.
    // 	--------------000207060703080505060404
    // 	Content-Disposition: attachment; filename="penguins.jpg"
    // 	Content-Type: image/jpeg; name="penguins.jpg"
    // 	Content-Transfer-Encoding: binary
    // 
    // 	<Binary Data Here>
    // 
    // 	--------------000207060703080505060404
    // 	Content-Disposition: attachment; filename="fishing.pdf"
    // 	Content-Type: application/pdf; name="fishing.pdf"
    // 	Content-Transfer-Encoding: binary
    // 
    // 	<Binary Data Here>
    // 
    // 	--------------000207060703080505060404--
    // 

    // Can we load this binary MIME into an Email object?
    binData = CkBinDataW_Create();
    // Write the binary MIME into binData;
    CkMimeW_GetMimeBd(mime,binData);

    email = CkEmailW_Create();
    // Load the email from the binData.
    CkEmailW_SetFromMimeBd(email,binData);

    // Note: Many email clients may not be able to correctly process emails
    // using the binary encoding.  Thunderbird has trouble.  Windows Live Mail
    // worked OK.
    CkEmailW_putSubject(email,L"Binary MIME Email");
    CkEmailW_putFrom(email,L"admin@chilkatsoft.com");
    CkEmailW_AddTo(email,L"Chilkat",L"support@chilkatsoft.com");
    CkEmailW_SaveEml(email,L"qa_output/binaryEmail.eml");

    // Chilkat does not recommend trying to use binary MIME for email.
    // Binary MIME is typically used in HTTP for uploads and downloads.
    // 

    // Also, binary MIME is not representable in a string.  
    // If we try to get the MIME as a string, then it must be encoded
    // using base64.

    // Chilkat automatically changes binary encodings to base64
    // when there's an attempt to get the MIME as a string.
    sb = CkStringBuilderW_Create();
    CkEmailW_GetMimeSb(email,sb);
    CkStringBuilderW_WriteFile(sb,L"qa_output/email_fromSb.eml",L"utf-8",FALSE);

    // Likewise, if we try to get the MIME as a string from the Mime object, 
    // it cannot contain non-character data in a binary encoding.  The binary
    // bytes MUST be in base64.  The act of trying to retrieve the MIME in string
    // format will force Chilkat to convert binary encodings (for non-text parts)
    // to base64.
    CkMimeW_GetMimeSb(mime,sb);
    CkStringBuilderW_WriteFile(sb,L"qa_output/mime_fromSb.eml",L"utf-8",FALSE);

    // However, the above use of base64 is just for the purpose of making the MIME
    // string friendly.  If we save the MIME to a file, it's still binary:
    CkMimeW_SaveMime(mime,L"qa_output/mime_binary.mime");


    CkMimeW_Dispose(mime);
    CkBinDataW_Dispose(binData);
    CkEmailW_Dispose(email);
    CkStringBuilderW_Dispose(sb);

    }