Enum PersonName.FieldModifier

java.lang.Object
java.lang.Enum<PersonName.FieldModifier>
com.ibm.icu.text.PersonName.FieldModifier
All Implemented Interfaces:
Serializable, Comparable<PersonName.FieldModifier>, java.lang.constant.Constable
Enclosing interface:
PersonName

public static enum PersonName.FieldModifier extends Enum<PersonName.FieldModifier>
Identifiers for the name field modifiers supported by the PersonName and PersonNameFormatter objects.
  • Nested Class Summary

    Nested classes/interfaces inherited from class java.lang.Enum

    Enum.EnumDesc<E extends Enum<E>>
  • Enum Constant Summary

    Enum Constants
    Enum Constant
    Description
    Requests the field value converted to ALL CAPS.
    If the field contains a main word with one or more separate prefixes, such as "van den Hul", this requests just the main word ("Hul").
    Requests an "informal" variant of the field, generally a nickname of some type: if "given" is "James", "given-informal" might be "Jimmy".
    Requests an initial for the specified field.
    Requests the field value with the first grapheme of each word converted to titlecase.
    Requests an initial for the specified field, suitable for use in a monogram (this usually differs from "initial" in that "initial" often adds a period and "monogram" never does).
    If the field contains a main word with one or more separate prefixes, such as "van den Hul", this requests just the prefixes ("van den").
  • Method Summary

    Modifier and Type
    Method
    Description
    Returns the appropriate fieldModifier for its display name.
    Returns the FieldModifier's display name.
    Returns the enum constant of this type with the specified name.
    Returns an array containing the constants of this enum type, in the order they are declared.

    Methods inherited from class java.lang.Object

    getClass, notify, notifyAll, wait, wait, wait
  • Enum Constant Details

    • INFORMAL

      public static final PersonName.FieldModifier INFORMAL
      Requests an "informal" variant of the field, generally a nickname of some type: if "given" is "James", "given-informal" might be "Jimmy". Only applied to the "given" field. If the PersonName object doesn't apply this modifier, PersonNameFormatter just uses the unmodified version of "given".
    • PREFIX

      public static final PersonName.FieldModifier PREFIX
      If the field contains a main word with one or more separate prefixes, such as "van den Hul", this requests just the prefixes ("van den"). Only applied to the "surname" field. If the PersonName object doesn't apply this modifier, PersonNameFormatter assumes there are no prefixes.
    • CORE

      public static final PersonName.FieldModifier CORE
      If the field contains a main word with one or more separate prefixes, such as "van den Hul", this requests just the main word ("Hul"). Only applied to the "surname" field. If the implementing class doesn't apply this modifier, PersonNameFormatter assumes the entire "surname" field is the "core".
    • INITIAL

      public static final PersonName.FieldModifier INITIAL
      Requests an initial for the specified field. PersonNameFormatter will do this algorithmically, but a PersonName object can apply this modifier itself if it wants different initial-generation logic (or stores the initial separately).
    • MONOGRAM

      public static final PersonName.FieldModifier MONOGRAM
      Requests an initial for the specified field, suitable for use in a monogram (this usually differs from "initial" in that "initial" often adds a period and "monogram" never does). PersonNameFormatter will do this algorithmically, but a PersonName object can apply this modifier itself if it wants different monogram-generation logic.
    • ALL_CAPS

      public static final PersonName.FieldModifier ALL_CAPS
      Requests the field value converted to ALL CAPS. PersonName objects generally won't need to handle this modifier themselves.
    • INITIAL_CAP

      public static final PersonName.FieldModifier INITIAL_CAP
      Requests the field value with the first grapheme of each word converted to titlecase. A PersonName object might handle this modifier itself to capitalize words more selectively.
  • Method Details

    • values

      public static PersonName.FieldModifier[] values()
      Returns an array containing the constants of this enum type, in the order they are declared.
      Returns:
      an array containing the constants of this enum type, in the order they are declared
    • valueOf

      public static PersonName.FieldModifier valueOf(String name)
      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
    • toString

      public String toString()
      Returns the FieldModifier's display name.
      Overrides:
      toString in class Enum<PersonName.FieldModifier>
    • forString

      public static PersonName.FieldModifier forString(String name)
      Returns the appropriate fieldModifier for its display name.