Класс CompactNumberFormat

public CompactNumberFormat(String decimalPattern, DecimalFormatSymbols symbols, String[] compactPatterns)

String[] compactPatterns = {"", "", "", "a lot"};
NumberFormat fmt = new CompactNumberFormat("00", DecimalFormatSymbols.getInstance(Locale.US), compactPatterns);
fmt.format(1); // returns "01"
fmt.format(1000); // returns "a lot"

Параметры:

decimalPattern — десятичный шаблон для форматирования чисел общего назначения

symbols — набор используемых символов

compactPatterns — массив компактных шаблонов чисел

Исключения:

NullPointerException — если любой из заданных аргументов равен null

IllegalArgumentException — если заданный decimalPattern или массив compactPatterns содержит недопустимый шаблон либо если в массиве компактных шаблонов встречается null

См. также:

• DecimalFormat(java.lang.String, DecimalFormatSymbols)
• DecimalFormatSymbols

public CompactNumberFormat(String decimalPattern, DecimalFormatSymbols symbols, String[] compactPatterns, String pluralRules)

Параметры:

decimalPattern — десятичный шаблон для форматирования чисел общего назначения

symbols — набор используемых символов

compactPatterns — массив компактных шаблонов чисел

pluralRules — строка, задающая правила множественного числа, связывающие ключевое слово Count, например «one», с фактическим целым числом. Синтаксис определен в синтаксисе правил множественного числа Консорциума Unicode

Исключения:

NullPointerException — если любой из заданных аргументов равен null

IllegalArgumentException — если заданный decimalPattern или массив compactPatterns содержит недопустимый шаблон, если в массиве компактных шаблонов встречается null либо если заданный pluralRules имеет недопустимый синтаксис

Начиная с:

14

Внешние спецификации

• Язык разметки данных локали Unicode (LDML)

См. также:

• DecimalFormat(java.lang.String, DecimalFormatSymbols)
• DecimalFormatSymbols

public final StringBuffer format(Object number, StringBuffer toAppendTo, FieldPosition fieldPosition)

Переопределяет:

format в классе NumberFormat

Параметры:

number — число для форматирования

toAppendTo — StringBuffer, к которому добавляется форматированный текст

fieldPosition — отслеживает позицию поля в возвращаемой строке. Например, при форматировании числа 123456789 в US locale, если заданный fieldPosition — это NumberFormat.INTEGER_FIELD, начальный и конечный индексы fieldPosition будут установлены в 0 и 3 соответственно для выходной строки 123M. Аналогичным образом позиции полей префикса и суффикса можно получить с помощью NumberFormat.Field.PREFIX и NumberFormat.Field.SUFFIX соответственно.

Возвращает:

toAppendTo, переданный в качестве StringBuffer

Исключения:

IllegalArgumentException — если number равно null или не является экземпляром Number

NullPointerException — если toAppendTo или fieldPosition равно null

ArithmeticException — если требуется округление, а в качестве режима округления задан RoundingMode.UNNECESSARY

См. также:

• FieldPosition

public StringBuffer format(double number, StringBuffer result, FieldPosition fieldPosition)

Определено в:

format в классе NumberFormat

Параметры:

number — число типа double для форматирования

result — место добавления текста

fieldPosition — отслеживает позицию поля в возвращаемой строке. Например, при форматировании числа 1234567.89 в US locale, если заданный fieldPosition — это NumberFormat.INTEGER_FIELD, начальный и конечный индексы fieldPosition будут установлены в 0 и 1 соответственно для выходной строки 1M. Аналогичным образом позиции полей префикса и суффикса можно получить с помощью NumberFormat.Field.PREFIX и NumberFormat.Field.SUFFIX соответственно.

Возвращает:

result, переданный в качестве StringBuffer

Исключения:

NullPointerException — если result или fieldPosition равно null

ArithmeticException — если требуется округление, а в качестве режима округления задан RoundingMode.UNNECESSARY

См. также:

• FieldPosition

public StringBuffer format(long number, StringBuffer result, FieldPosition fieldPosition)

Определено в:

format в классе NumberFormat

Параметры:

number — число типа long для форматирования

result — место добавления текста

fieldPosition — отслеживает позицию поля в возвращаемой строке. Например, при форматировании числа 123456789 в US locale, если заданный fieldPosition — это NumberFormat.INTEGER_FIELD, начальный и конечный индексы fieldPosition будут установлены в 0 и 3 соответственно для выходной строки 123M. Аналогичным образом позиции полей префикса и суффикса можно получить с помощью NumberFormat.Field.PREFIX и NumberFormat.Field.SUFFIX соответственно.

Возвращает:

result, переданный в качестве StringBuffer

Исключения:

NullPointerException — если result или fieldPosition равно null

ArithmeticException — если требуется округление, а в качестве режима округления задан RoundingMode.UNNECESSARY

См. также:

• FieldPosition

public AttributedCharacterIterator formatToCharacterIterator(Object obj)

Переопределяет:

formatToCharacterIterator в классе Format

Параметры:

obj — объект для форматирования

Возвращает:

AttributedCharacterIterator с описанием форматированного значения

Исключения:

NullPointerException — если obj равно null

IllegalArgumentException — если Format не может отформатировать заданный объект

ArithmeticException — если требуется округление, а в качестве режима округления задан RoundingMode.UNNECESSARY

public Number parse(String text, ParsePosition pos)

Определено в:

parse в классе NumberFormat

Параметры:

text — строка для разбора

pos — объект ParsePosition с информацией об индексе и индексе ошибки, как описано выше

Возвращает:

разобранное значение или null, если разбор не удался

Исключения:

NullPointerException — если text или pos равно null

См. также:

• NumberFormat.isStrict()

public void setMaximumIntegerDigits(int newValue)

Переопределяет:

setMaximumIntegerDigits в классе NumberFormat

Параметры:

newValue — максимальное количество отображаемых целых цифр.

См. также:

• NumberFormat.getMaximumIntegerDigits()

public void setMinimumIntegerDigits(int newValue)

Переопределяет:

setMinimumIntegerDigits в классе NumberFormat

Параметры:

newValue — минимальное количество отображаемых целых цифр.

См. также:

• NumberFormat.getMinimumIntegerDigits()

public void setMinimumFractionDigits(int newValue)

Переопределяет:

setMinimumFractionDigits в классе NumberFormat

Параметры:

newValue — минимальное количество отображаемых дробных цифр.

См. также:

• NumberFormat.getMinimumFractionDigits()

public void setMaximumFractionDigits(int newValue)

Переопределяет:

setMaximumFractionDigits в классе NumberFormat

Параметры:

newValue — максимальное количество отображаемых дробных цифр.

См. также:

• NumberFormat.getMaximumFractionDigits()

public RoundingMode getRoundingMode()

Переопределяет:

getRoundingMode в классе NumberFormat

Возвращает:

RoundingMode, используемый для этого CompactNumberFormat

См. также:

• setRoundingMode(RoundingMode)

public void setRoundingMode(RoundingMode roundingMode)

Переопределяет:

setRoundingMode в классе NumberFormat

Параметры:

roundingMode — используемый RoundingMode

Исключения:

NullPointerException — если roundingMode равно null

См. также:

• getRoundingMode()

public int getGroupingSize()

Возвращает:

размер группы

См. также:

• setGroupingSize(int)
• NumberFormat.isGroupingUsed()
• DecimalFormatSymbols.getGroupingSeparator()

public void setGroupingSize(int newValue)

Параметры:

newValue — новый размер группы

Исключения:

IllegalArgumentException — если newValue отрицательно или превышает 127

См. также:

• getGroupingSize()
• NumberFormat.setGroupingUsed(boolean)
• DecimalFormatSymbols.setGroupingSeparator(char)

public boolean isGroupingUsed()

Переопределяет:

isGroupingUsed в классе NumberFormat

Возвращает:

true, если используется группировка; в противном случае — false

См. также:

• setGroupingUsed(boolean)

public void setGroupingUsed(boolean newValue)

Переопределяет:

setGroupingUsed в классе NumberFormat

Параметры:

newValue — true, если используется группировка; в противном случае — false

См. также:

• isGroupingUsed()

public boolean isParseIntegerOnly()

Переопределяет:

isParseIntegerOnly в классе NumberFormat

Требования к реализации:

Эта реализация устанавливает индекс ParsePosition не в позицию десятичного символа, а в конец строки.

Возвращает:

true, если компактные числа следует разбирать только как целые; в противном случае — false

public void setParseIntegerOnly(boolean value)

Переопределяет:

setParseIntegerOnly в классе NumberFormat

Параметры:

value — true, если компактные числа следует разбирать только как целые; в противном случае — false

См. также:

• isParseIntegerOnly()

public boolean isStrict()

Переопределяет:

isStrict в классе NumberFormat

Возвращает:

true, если этот формат разбирает числа в строгом режиме; в противном случае — false

Начиная с:

23

См. также:

• setStrict(boolean)
• parse(String, ParsePosition)

public void setStrict(boolean strict)

Переопределяет:

setStrict в классе NumberFormat

Параметры:

strict — true, если разбор должен выполняться в строгом режиме; в противном случае — false

Начиная с:

23

См. также:

• isStrict()
• parse(String, ParsePosition)

public boolean isParseBigDecimal()

Возвращает:

true, если метод разбора возвращает BigDecimal; в противном случае — false

См. также:

• setParseBigDecimal(boolean)

public void setParseBigDecimal(boolean newValue)

Параметры:

newValue — true, если метод разбора возвращает BigDecimal; в противном случае — false

См. также:

• isParseBigDecimal()

public boolean equals(Object obj)

Переопределяет:

equals в классе NumberFormat

Требования к реализации:

Этот метод проверяет равенство, определяя идентичность класса на основе getClass(), а не instanceof. Поэтому в методах equals подклассов ни один экземпляр этого класса не должен считаться равным экземпляру подкласса.

Параметры:

obj — объект для сравнения

Возвращает:

true, если этот объект равен другому CompactNumberFormat

См. также:

• Object.hashCode()

public int hashCode()

Переопределяет:

hashCode в классе NumberFormat

Требования к реализации:

Для вычисления значения хеш-кода используются нетранзиентные поля экземпляра этого класса, что соответствует контракту, определенному в Objects.hashCode(Object)

Возвращает:

хеш-код этого CompactNumberFormat

См. также:

• Object.hashCode()

public String toString()

Переопределяет:

toString в классе Object

Возвращает:

строку, идентифицирующую этот CompactNumberFormat, для отладки

public CompactNumberFormat clone()

Переопределяет:

clone в классе NumberFormat

Возвращает:

клон этого экземпляра

См. также:

• Cloneable