ChoiceFormat (Платформа Java SE 8 b92)

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, Сериализированная Форма

Вложенная Сводка Класса
- Вложенные классы/интерфейсы, наследованные от class java.text. NumberFormat
  NumberFormat. Поле

Полевая Сводка
- Поля, наследованные от class 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()` Получает образец.

Методы, наследованные от class java.text. Формат
format, formatToCharacterIterator, parseObject

Методы, наследованные от class 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 - См. описание class.
  - 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 в class NumberFormat
    
    См. Также:
    
    Format.format(java.lang.Object)
  - формат
```
public StringBuffer format(double number,
                           StringBuffer toAppendTo,
                           FieldPosition status)
```
    Образец возвратов с двойным отформатированным.
    
    Определенный:
    
    format в class NumberFormat
    
    Параметры:
    
    number - число, которое будет отформатировано & заменено.
    
    toAppendTo - где текст добавляется.
    
    status - не проигнорируйте полезное состояние, возвращается.
    
    См. Также:
    
    Format.format(java.lang.Object)
  - синтаксический анализ
```
public Number parse(String text,
                    ParsePosition status)
```
    Анализирует Число из входного текста.
    
    Определенный:
    
    parse в class 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 в class NumberFormat
    
    Возвраты:
    
    клон этого экземпляра.
    
    См. Также:
    
    Cloneable
  - хэш-код
```
public int hashCode()
```
    Генерирует хэш-код для объекта формата сообщения.
    
    Переопределения:
    
    hashCode в class NumberFormat
    
    Возвраты:
    
    значение хэш-кода для этого объекта.
    
    См. Также:
    
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - равняется
```
public boolean equals(Object obj)
```
    Равенство comparision между два
    
    Переопределения:
    
    equals в class 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

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92

Класс ChoiceFormat

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

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

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

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

Поля, наследованные от class java.text. NumberFormat

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

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

Методы, наследованные от class java.text. NumberFormat

Методы, наследованные от class java.text. Формат

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

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

ChoiceFormat

ChoiceFormat

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

applyPattern

toPattern

setChoices

getLimits

getFormats

формат

формат

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

nextDouble

previousDouble

клон

хэш-код

равняется

nextDouble