(Android™) 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.

Chilkat Android™ Downloads Android™ Java Libraries Android C/C++ Libraries

// Important: Don't forget to include the call to System.loadLibrary
// as shown at the bottom of this code sample.
package com.test;

import android.app.Activity;
import com.chilkatsoft.*;

import android.widget.TextView;
import android.os.Bundle;

public class SimpleActivity extends Activity {

  private static final String TAG = "Chilkat";

  // Called when the activity is first created.
  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // This example assumes the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    CkMime mime = new CkMime();

    // 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:
    Log.i(TAG, mime.getMime());

    // 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...
    Log.i(TAG, mime.getMime());

    // 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

  }

  static {
      System.loadLibrary("chilkat");

      // Note: If the incorrect library name is passed to System.loadLibrary,
      // then you will see the following error message at application startup:
      //"The application <your-application-name> has stopped unexpectedly. Please try again."
  }
}