Setting the MIME Text Charset (such as utf-8, iso-8859-1, etc.)

Demonstrates how setting the Charset property controls the character encoding used for the text body in a MIME message.

Downloads for Windows/Linux and Install Instructions

require 'rubygems'
require 'chilkat'

mime = Chilkat::CkMime.new()

success = mime.UnlockComponent("Anything for 30-day trial.")
if (success == false)
    print mime.lastErrorText() + "\n";
    exit
end

#  Set the MIME body using some 8bit non-us-ascii characters:
mime.SetBody("á, é, í, ó, ú")

#  Set the Content-Type
mime.put_ContentType("text/plain")

#  Set the Content-Transfer-Encoding to "quoted-printable"
#  so it's easy to see the bytes used to encode each character
#  (i.e. it will be easy to see that utf-8 uses 2-bytes for
#  non-us-ascii characters such as "á", whereas a character
#  encoding such as iso-8859-1 will use one byte per character.
mime.put_Encoding("quoted-printable")

#  Set the Charset to utf-8
mime.put_Charset("utf-8")

#  Examine the MIME:
print mime.getMime() + "\n";

#  The MIME should look like this:
#  
Content-Transfer-Encoding: quoted-printable
Content-Type: text/plain; charset="utf-8"

=C3=A1, =C3=A9, =C3=AD, =C3=B3, =C3=BA

#  Now change the Charset to "iso-8859-1"
mime.put_Charset("iso-8859-1")

#  Get the MIME again...
print mime.getMime() + "\n";

#  Now the MIME should look like this:
#  
Content-Transfer-Encoding: quoted-printable
Content-Type: text/plain; charset="iso-8859-1"

=E1, =E9, =ED, =F3, =FA