java.text

Класс ChoiceFormat

java.lang. Объект

java.text. Формат

java.text. NumberFormat

java.text. ChoiceFormat

Все Реализованные Интерфейсы:

Сериализуемый, Cloneable

public class ChoiceFormat
extends NumberFormat

A ChoiceFormat позволяет Вам присоединять формат к диапазону чисел. Это обычно используется в a MessageFormat для того, чтобы обработать множественные числа. Выбор определяется с возрастающим списком, удваивается, где каждый элемент определяет полуоткрытый интервал до следующего элемента:

 X matches j if and only if limit[j] <= X < limit[j+1]
 

Если там не идет ни в какое сравнение, то или первый или последний индекс используется, в зависимости от того, слишком низок ли номер (X) или слишком высок. Если предельный массив не будет в порядке возрастания, то результаты форматирования будут неправильными. ChoiceFormat также принимает \u221E как эквивалентный бесконечности (INF).

Отметьте: ChoiceFormat отличается от другого Format классы в этом Вы создаете a ChoiceFormat объект с конструктором (не с a getInstance метод фабрики стиля). Методы фабрики не необходимы потому что ChoiceFormat не требует никакой сложной установки для данной локали. Фактически, ChoiceFormat не реализует локали определенное поведение.

Создавая a ChoiceFormat, следует определить массив форматов и массив пределов. Длина этих массивов должна быть тем же самым. Например,

• пределы = {1,2,3,4,5,6,7}
  форматы = {"Sun", "понедельник", "вторник", "Wed", "Thur", "пятница", "Находились"}
• пределы = {0, 1, ChoiceFormat.nextDouble (1)}
  форматы = {"никакие файлы", "один файл", "много файлов"}
  (nextDouble может использоваться, чтобы получить следующее, выше двойное, сделать полуоткрытый интервал.)

Вот простой пример, который показывает форматирование и парсинг:

 double[] limits = {1,2,3,4,5,6,7};
 String[] dayOfWeekNames = {"Sun","Mon","Tue","Wed","Thur","Fri","Sat"};
 ChoiceFormat form = new ChoiceFormat(limits, dayOfWeekNames);
 ParsePosition status = new ParsePosition(0);
 for (double i = 0.0; i <= 8.0; ++i) {
     status.setIndex(0);
     System.out.println(i + " -> " + form.format(i) + " -> "
                              + form.parse(form.format(i),status));
 }
 

Вот более сложный пример с форматом образца:

 double[] filelimits = {0,1,2};
 String[] filepart = {"are no files","is one file","are {2} files"};
 ChoiceFormat fileform = new ChoiceFormat(filelimits, filepart);
 Format[] testFormats = {fileform, null, NumberFormat.getInstance()};
 MessageFormat pattform = new MessageFormat("There {0} on {1}");
 pattform.setFormats(testFormats);
 Object[] testArgs = {null, "ADisk", null};
 for (int i = 0; i < 4; ++i) {
     testArgs[0] = new Integer(i);
     testArgs[2] = testArgs[0];
     System.out.println(pattform.format(testArgs));
 }
 

Определение образца для объектов ChoiceFormat является довольно прямым. Например:

 ChoiceFormat fmt = new ChoiceFormat(
      "-1#is negative| 0#is zero or fraction | 1#is one |1.0<is 1+ |2#is two |2<is more than 2.");
 System.out.println("Formatter Pattern : " + fmt.toPattern());

 System.out.println("Format with -INF : " + fmt.format(Double.NEGATIVE_INFINITY));
 System.out.println("Format with -1.0 : " + fmt.format(-1.0));
 System.out.println("Format with 0 : " + fmt.format(0));
 System.out.println("Format with 0.9 : " + fmt.format(0.9));
 System.out.println("Format with 1.0 : " + fmt.format(1));
 System.out.println("Format with 1.5 : " + fmt.format(1.5));
 System.out.println("Format with 2 : " + fmt.format(2));
 System.out.println("Format with 2.1 : " + fmt.format(2.1));
 System.out.println("Format with NaN : " + fmt.format(Double.NaN));
 System.out.println("Format with +INF : " + fmt.format(Double.POSITIVE_INFINITY));
 

И выходной результат походил бы на следующее:

   Format with -INF : is negative
   Format with -1.0 : is negative
   Format with 0 : is zero or fraction
   Format with 0.9 : is zero or fraction
   Format with 1.0 : is one
   Format with 1.5 : is 1+
   Format with 2 : is two
   Format with 2.1 : is more than 2.
   Format with NaN : is negative
   Format with +INF : is more than 2.
 

Синхронизация

Форматы выбора не синхронизируются. Рекомендуется создать отдельные экземпляры формата для каждого потока. Если многократные потоки получают доступ к формату одновременно, он должен синхронизироваться внешне.

См. Также:

DecimalFormat, MessageFormat, Сериализированная Форма

Вложенная Сводка Класса

Вложенные классы/интерфейсы java.text унаследованный от класса. NumberFormat

NumberFormat. Поле

Полевая Сводка

Поля java.text унаследованный от класса. NumberFormat

FRACTION_FIELD, INTEGER_FIELD

Сводка конструктора

Конструкторы

Конструктор и Описание
ChoiceFormat(double[] limits, String[] formats) Конструкции с пределами и соответствующими форматами.
ChoiceFormat(String newPattern) Конструкции с пределами и соответствующими форматами, основанными на образце.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
void	applyPattern(String newPattern) Устанавливает образец.
Объект	clone() Переопределения Cloneable
boolean	equals(Object obj) Равенство comparision между два
StringBuffer	format(double number, StringBuffer toAppendTo, FieldPosition status) Образец возвратов с двойным отформатированным.
StringBuffer	format(long number, StringBuffer toAppendTo, FieldPosition status) Специализация формата.
Объект[]	getFormats() Передайте форматы в конструкторе.
double[]	getLimits() Передайте пределы в конструкторе.
int	hashCode() Генерирует хэш-код для объекта формата сообщения.
static double	nextDouble(double d) Находит наименее двойное большее чем d.
static double	nextDouble(double d, boolean positive) Находит наименее двойное большее чем d (если положительный == истина), или самые большие двойные меньше чем d (если положительный == ложь).
Число	parse(String text, ParsePosition status) Анализирует Число из входного текста.
static double	previousDouble(double d) Находит самые большие двойные меньше чем d.
void	setChoices(double[] limits, String[] formats) Установите варианты, которые будут использоваться в форматировании.
Строка	toPattern() Получает образец.

Методы java.text унаследованный от класса. NumberFormat

format, format, format, getAvailableLocales, getCurrency, getCurrencyInstance, getCurrencyInstance, getInstance, getInstance, getIntegerInstance, getIntegerInstance, getMaximumFractionDigits, getMaximumIntegerDigits, getMinimumFractionDigits, getMinimumIntegerDigits, getNumberInstance, getNumberInstance, getPercentInstance, getPercentInstance, getRoundingMode, isGroupingUsed, isParseIntegerOnly, parse, parseObject, setCurrency, setGroupingUsed, setMaximumFractionDigits, setMaximumIntegerDigits, setMinimumFractionDigits, setMinimumIntegerDigits, setParseIntegerOnly, setRoundingMode

Методы java.text унаследованный от класса. Формат

format, formatToCharacterIterator, parseObject

Методы java.lang унаследованный от класса. Объект

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Деталь конструктора

ChoiceFormat

public ChoiceFormat(String newPattern)

Конструкции с пределами и соответствующими форматами, основанными на образце.

См. Также:

applyPattern(java.lang.String)

ChoiceFormat

public ChoiceFormat(double[] limits,
            String[] formats)

Конструкции с пределами и соответствующими форматами.

См. Также:

setChoices(double[], java.lang.String[])

Деталь метода

applyPattern

public void applyPattern(String newPattern)

Устанавливает образец.

Параметры:

newPattern - См. описание класса.

toPattern

public String toPattern()

Получает образец.

setChoices

public void setChoices(double[] limits,
              String[] formats)

Установите варианты, которые будут использоваться в форматировании.

Параметры:

limits - содержит главное значение, которое хотите проанализированный с тем форматом, и следует быть в возрастающем сортированном порядке. Форматируя X, выбором будет я, где предел [я] <= X <предел [i+1]. Если предельный массив не будет в порядке возрастания, то результаты форматирования будут неправильными.

formats - форматы, которые Вы хотите использовать для каждого предела. Они могут быть или объектами Формата или Строками. Форматируя с объектом Y, если объектом является NumberFormat, то ((NumberFormat) Y).format (X) вызывается. Иначе Y.toString () вызывают.

getLimits

public double[] getLimits()

Передайте пределы в конструкторе.

Возвраты:

пределы.

getFormats

public Object[] getFormats()

Передайте форматы в конструкторе.

Возвраты:

форматы.

формат

public StringBuffer format(long number,
                  StringBuffer toAppendTo,
                  FieldPosition status)

Специализация формата. Этот метод действительно вызывает format(double, StringBuffer, FieldPosition) таким образом диапазон longs, которые поддерживаются, только равен диапазону, который может быть сохранен двойным. Это никогда не будет практическим ограничением.

Определенный:

format в классе NumberFormat

См. Также:

Format.format(java.lang.Object)

формат

public StringBuffer format(double number,
                  StringBuffer toAppendTo,
                  FieldPosition status)

Образец возвратов с двойным отформатированным.

Определенный:

format в классе NumberFormat

Параметры:

number - число, которое будет отформатировано & заменено.

toAppendTo - где текст добавляется.

status - не проигнорируйте полезное состояние, возвращается.

См. Также:

Format.format(java.lang.Object)

синтаксический анализ

public Number parse(String text,
           ParsePosition status)

Анализирует Число из входного текста.

Определенный:

parse в классе NumberFormat

Параметры:

text - исходный текст.

status - параметр ввода - вывода. На вводе status.index поле указывает на первый символ исходного текста, который должен быть проанализирован. На выходе, если никакая ошибка не произошла, status.index устанавливается в первый непроанализированный символ в исходном тексте. На выходе, если ошибка действительно происходила, status.index неизменен, и status.errorIndex устанавливается в первый индекс символа, который заставил синтаксический анализ перестать работать.

Возвраты:

Число, представляющее значение числа, проанализировано.

См. Также:

NumberFormat.isParseIntegerOnly(), Format.parseObject(java.lang.String, java.text.ParsePosition)

nextDouble

public static final double nextDouble(double d)

Находит наименее двойное большее чем d. Если НЭН, возвращает то же самое значение.

Используемый, чтобы сделать полуоткрытые интервалы.

См. Также:

previousDouble(double)

previousDouble

public static final double previousDouble(double d)

Находит самые большие двойные меньше чем d. Если НЭН, возвращает то же самое значение.

См. Также:

nextDouble(double)

клон

public Object clone()

Переопределения Cloneable

Переопределения:

clone в классе NumberFormat

Возвраты:

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

См. Также:

Cloneable

хэш-код

public int hashCode()

Генерирует хэш-код для объекта формата сообщения.

Переопределения:

hashCode в классе NumberFormat

Возвраты:

значение хэш-кода для этого объекта.

См. Также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

равняется

public boolean equals(Object obj)

Равенство comparision между два

Переопределения:

equals в классе NumberFormat

Параметры:

obj - ссылочный объект, с которым можно сравниться.

Возвраты:

true если этот объект является тем же самым как obj параметром; false иначе.

См. Также:

Object.hashCode(), HashMap

nextDouble

public static double nextDouble(double d,
                boolean positive)

Находит наименее двойное большее чем d (если положительный == истина), или самые большие двойные меньше чем d (если положительный == ложь). Если НЭН, возвращает то же самое значение. Не влияет на флаги с плавающей точкой, если эти функции членства не делают: Double.longBitsToDouble (долго) Double.doubleToLongBits (двойной) (двойной) Double.isNaN