Set the Charset of an Attachment

See more Email Object Examples

Demonstrates the Chilkat Email.SetAttachmentCharset method, which sets the charset parameter of the Content-Type header field for the attachment at a given zero-based index. This example adds a text attachment and sets its charset to utf-8.

Background: For a text attachment, the charset parameter tells the receiving client which character encoding the bytes use, so accented or non-Latin text renders correctly. Setting it explicitly (typically utf-8) removes ambiguity when the attachment contains non-ASCII content — without it, a client may guess wrong and display garbled characters.

Chilkat C Downloads

Download Chilkat for C

#include <C_CkEmail.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkEmail email;

    success = FALSE;

    //  Demonstrates the SetAttachmentCharset method, which sets the charset parameter of the
    //  Content-Type header field for the attachment at the given zero-based index.

    email = CkEmail_Create();
    CkEmail_putSubject(email,"Set attachment charset");

    CkEmail_AddStringAttachment(email,"notes.txt","Some notes.");

    //  Set the charset of the first attachment (index 0) to utf-8.
    success = CkEmail_SetAttachmentCharset(email,0,"utf-8");
    if (success == FALSE) {
        printf("%s\n",CkEmail_lastErrorText(email));
        CkEmail_Dispose(email);
        return;
    }

    //  The attachment's Content-Type now includes charset="utf-8".
    printf("%s\n",CkEmail_getMime(email));


    CkEmail_Dispose(email);

    }