| /* GENERATED SOURCE. DO NOT MODIFY. */ |
| // ? 2018 and later: Unicode, Inc. and others. |
| // License & terms of use: http://www.unicode.org/copyright.html |
| |
| package android.icu.text; |
| |
| import android.icu.util.ICUUncheckedIOException; |
| import java.text.AttributedCharacterIterator; |
| |
| /** |
| * An abstract formatted value: a string with associated field attributes. |
| * Many formatters format to classes implementing FormattedValue. |
| * |
| * @author sffc |
| */ |
| |
| @SuppressWarnings({"unchecked", "deprecation", "all"}) |
| public interface FormattedValue extends java.lang.CharSequence { |
| |
| /** |
| * Returns the formatted string as a Java String. |
| * |
| * Consider using {@link #appendTo} for greater efficiency. |
| * |
| * @return The formatted string. |
| */ |
| |
| public java.lang.String toString(); |
| |
| /** |
| * Appends the formatted string to an Appendable. |
| * <p> |
| * If an IOException occurs when appending to the Appendable, an unchecked |
| * {@link android.icu.util.ICUUncheckedIOException ICUUncheckedIOException} is thrown instead. |
| * |
| * @param appendable The Appendable to which to append the string output. |
| * @return The same Appendable, for chaining. |
| * @throws android.icu.util.ICUUncheckedIOException if the Appendable throws IOException |
| */ |
| |
| public <A extends java.lang.Appendable> A appendTo(A appendable); |
| |
| /** |
| * 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: |
| * |
| * <pre> |
| * ConstrainableFieldPosition cfpos = new ConstrainableFieldPosition(); |
| * while (fmtval.nextPosition(cfpos)) { |
| * // handle the field position; get information from cfpos |
| * } |
| * </pre> |
| * |
| * @param cfpos |
| * The object used for iteration state. This can provide constraints to iterate over |
| * only one specific field; see {@link android.icu.text.ConstrainedFieldPosition#constrainField ConstrainedFieldPosition#constrainField}. |
| * @return true if a new occurrence of the field was found; |
| * false otherwise. |
| */ |
| |
| public boolean nextPosition(android.icu.text.ConstrainedFieldPosition cfpos); |
| |
| /** |
| * Exports the formatted number as an AttributedCharacterIterator. |
| * <p> |
| * Consider using {@link #nextPosition} if you are trying to get field information. |
| * |
| * @return An AttributedCharacterIterator containing full field information. |
| */ |
| |
| public java.text.AttributedCharacterIterator toCharacterIterator(); |
| } |
| |