Lua

Remove the Plain-Text Body from an Email

Demonstrates the Chilkat Email.RemovePlainTextAlternative method, which removes the plain-text body from the email if one exists. Other body representations, attachments, and related items remain unchanged. This example builds a message with both plain-text and HTML alternatives, then removes the plain text.

Background: This is the counterpart to RemoveHtmlAlternative. Removing the plain-text alternative leaves an HTML-only message. Note that dropping the plain-text fallback is generally discouraged for real mail — it hurts accessibility and can raise spam scores — but it is occasionally needed when a downstream system expects a single HTML representation.

Chilkat Lua Downloads

Download Chilkat for Lua

Lua

local chilkat = require("chilkat")

-- Demonstrates the RemovePlainTextAlternative method, which removes the plain-text body
-- from the email (if one exists).  Other body representations, attachments, and related
-- items remain.

local email = chilkat.Email.new()
email.subject = "Remove plain-text alternative"

-- Create an email with both plain-text and HTML alternatives.
email:set_text_body("This is the plain-text version.", "text/plain")
email:add_html_alternative_body("<html><body>This is the HTML version.</body></html>")
print("NumAlternatives before = " .. email.num_alternatives)
print("HasPlainTextBody before: " .. tostring(email:has_plain_text_body()))

-- Remove the plain-text body, leaving the HTML alternative.
email:remove_plain_text_alternative()
print("NumAlternatives after = " .. email.num_alternatives)
print("HasPlainTextBody after: " .. tostring(email:has_plain_text_body()))