Interface FormattedValue

All Superinterfaces:
CharSequence
All Known Implementing Classes:
DateIntervalFormat.FormattedDateInterval, FormattedMessage, FormattedNumber, FormattedNumberRange, ListFormatter.FormattedList, PlainStringFormattedValue, RelativeDateTimeFormatter.FormattedRelativeDateTime
public interface FormattedValue extends CharSequence
An abstract formatted value: a string with associated field attributes. Many formatters format to classes implementing FormattedValue.

  • Method Details

    • toString

      String toString()
      Returns the formatted string as a Java String. Consider using appendTo(A) for greater efficiency.
      Specified by:
      toString in interface CharSequence
      Overrides:
      toString in class Object
      Returns:
      The formatted string.

    • appendTo

      <A extends Appendable> A appendTo(A appendable)
      Appends the formatted string to an Appendable.

      If an IOException occurs when appending to the Appendable, an unchecked ICUUncheckedIOException is thrown instead.

      Parameters:
      appendable - The Appendable to which to append the string output.
      Returns:
      The same Appendable, for chaining.
      Throws:
      ICUUncheckedIOException - if the Appendable throws IOException

    • nextPosition

      boolean nextPosition(ConstrainedFieldPosition cfpos)
      Iterates over field positions in the FormattedValue. This lets you determine the position of specific types of substrings, like a month or a decimal separator. To loop over all field positions: 
           ConstrainedFieldPosition cfpos = new ConstrainedFieldPosition();
     while (fmtval.nextPosition(cfpos)) {
         // handle the field position; get information from cfpos
     }
      Parameters:
      cfpos - The object used for iteration state. This can provide constraints to iterate over only one specific field; see ConstrainedFieldPosition.constrainField(java.text.Format.Field).
      Returns:
      true if a new occurrence of the field was found; false otherwise.

    • toCharacterIterator

      AttributedCharacterIterator toCharacterIterator()
      Exports the formatted number as an AttributedCharacterIterator.

      Consider using nextPosition(org.graalvm.shadowed.com.ibm.icu.text.ConstrainedFieldPosition) if you are trying to get field information.

      Returns:
      An AttributedCharacterIterator containing full field information.