com.ibm.icu.text

Enum PersonNameFormatter.Usage

java.lang.Object

java.lang.Enum<PersonNameFormatter.Usage>

com.ibm.icu.text.PersonNameFormatter.Usage

All Implemented Interfaces:

Serializable, Comparable<PersonNameFormatter.Usage>

Enclosing class:

PersonNameFormatter

Deprecated.

This API is for technology preview only.

@Deprecated
public static enum PersonNameFormatter.Usage
extends Enum<PersonNameFormatter.Usage>

Specifies the intended usage of the formatted name.

Status:

Technology Preview. This API is still in the early stages of development. Use at your own risk.

Enum Constant Summary

Enum Constants

Enum Constant and Description
ADDRESSING Deprecated. This API is for technology preview only.
MONOGRAM Deprecated. This API is for technology preview only.
REFERRING Deprecated. This API is for technology preview only.

Method Summary

Modifier and Type	Method and Description
static PersonNameFormatter.Usage	valueOf(String name) Deprecated. Returns the enum constant of this type with the specified name.
static PersonNameFormatter.Usage[]	values() Deprecated. Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

ADDRESSING

@Deprecated
public static final PersonNameFormatter.Usage ADDRESSING

Deprecated. This API is for technology preview only.

Used for when the name is going to be used to address the user directly: "Turn left here, John."

Status:

Technology Preview. This API is still in the early stages of development. Use at your own risk.

REFERRING

@Deprecated
public static final PersonNameFormatter.Usage REFERRING

Deprecated. This API is for technology preview only.

Used in general cases, when the name is used to refer to somebody else.

Status:

Technology Preview. This API is still in the early stages of development. Use at your own risk.

MONOGRAM

@Deprecated
public static final PersonNameFormatter.Usage MONOGRAM

Deprecated. This API is for technology preview only.

Used to generate monograms, short 1 to 3-character versions of the name suitable for use in things like chat avatars. In English, this is usually the person's initials, but this isn't true in all languages. When the caller specifies Usage.MONOGRAM, the Length parameter can be used to get different lengths of monograms: Length.SHORT is generally a single letter; Length.LONG may be as many as three or four.

Status:

Technology Preview. This API is still in the early stages of development. Use at your own risk.

Method Detail

values

public static PersonNameFormatter.Usage[] values()

Deprecated.

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (PersonNameFormatter.Usage c : PersonNameFormatter.Usage.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static PersonNameFormatter.Usage valueOf(String name)

Deprecated.

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null