Unicode C

Get an Attachment as a Text String

Demonstrates the Chilkat Email.GetAttachmentString method, which returns the Nth attachment's data as text. The first argument is the zero-based attachment index and the second is the charset used to interpret the attachment bytes. This example reads a text attachment as utf-8.

Background: Attachments are stored as bytes, so turning one back into a string requires knowing its charset — the rule for mapping bytes to characters. Supplying the correct charset (often utf-8) yields readable text; the wrong one produces garbled characters. This method is meant for text attachments such as .txt, .csv, or .xml; binary attachments should be handled as raw data instead.

Chilkat Unicode C Downloads

Download Chilkat for Unicode C

Unicode C

#include <C_CkEmailW.h>

void ChilkatSample(void)
    {
    HCkEmailW email;
    const wchar_t *content;

    //  Demonstrates the GetAttachmentString method, which returns the Nth attachment's data as
    //  text.  The first argument is the zero-based attachment index and the second is the charset used to interpret
    //  the attachment bytes.

    email = CkEmailW_Create();
    CkEmailW_putSubject(email,L"Attachment as text");

    CkEmailW_AddStringAttachment(email,L"notes.txt",L"These are the notes stored in the attachment.");

    //  Get the first attachment (index 0) as text, interpreting the bytes as utf-8.
    content = CkEmailW_getAttachmentString(email,0,L"utf-8");
    wprintf(L"Attachment 0 text: %s\n",content);


    CkEmailW_Dispose(email);

    }