Get an Alternative Body by Content-Type

See more Email Object Examples

Demonstrates the Chilkat Email.GetAlternativeBodyByContentType method, which returns an alternative body selected by its Content-Type — such as text/plain, text/html, or text/xml — instead of by numeric index. This example retrieves both the plain-text and HTML alternatives by content type.

Background: Selecting by Content-Type is often more convenient than by index, because you usually know which representation you want (the HTML, say) but not its position in the alternative list. This mirrors how a mail client works — it looks up the best matching type to display — and avoids assumptions about ordering, which can vary between messages.

Chilkat C Downloads

Download Chilkat for C

#include <C_CkEmail.h>

void ChilkatSample(void)
    {
    HCkEmail email;
    const char *plain;
    const char *htmlBody;

    //  Demonstrates the GetAlternativeBodyByContentType method, which returns an alternative
    //  body selected by its Content-Type (such as text/plain, text/html, or text/xml) rather
    //  than by index.

    email = CkEmail_Create();

    //  Create an email with plain-text and HTML alternatives.
    CkEmail_SetTextBody(email,"This is the plain-text alternative.","text/plain");
    CkEmail_AddHtmlAlternativeBody(email,"<html><body>This is the HTML alternative.</body></html>");

    //  Get the plain-text alternative by its content type.
    plain = CkEmail_getAlternativeBodyByContentType(email,"text/plain");
    printf("text/plain body: %s\n",plain);

    //  Get the HTML alternative by its content type.
    htmlBody = CkEmail_getAlternativeBodyByContentType(email,"text/html");
    printf("text/html body: %s\n",htmlBody);


    CkEmail_Dispose(email);

    }