Sample code for 30+ languages & platforms
Android™

Get a To Recipient's Name Only

See more Email Object Examples

Demonstrates the Chilkat Email.GetToName method, which returns only the friendly-name part (not the address) of the Nth To recipient. The index is zero-based. This example adds two To recipients and prints each one's display name.

Background: The display name is the human-friendly label attached to an address, like Joe Smith for joe@example.com. It is optional and purely cosmetic but useful for presentation. GetToName returns just that name; if a recipient was added without one, the result is empty, in which case fall back to GetToAddr.

Chilkat Android™ Downloads

Android™
// 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);

    //  Demonstrates the GetToName method, which returns only the friendly-name part (not the
    //  address) of the Nth To recipient.  The index is zero-based.

    CkEmail email = new CkEmail();
    email.put_Subject("GetToName example");

    email.AddTo("Joe Smith","joe@example.com");
    email.AddTo("Jane Doe","jane@example.com");

    int n = email.get_NumTo();
    int i;
    for (i = 0; i <= n - 1; i++) {
        Log.i(TAG, "To " + String.valueOf(i) + " name: " + email.getToName(i));
        }


  }

  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."
  }
}