compact1, compact2, compact3

java.text

Класс RuleBasedCollator

java.lang. Объект

java.text. Сортировально-подборочная машина

java.text. RuleBasedCollator

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

Cloneable, Компаратор <Объект>

public class RuleBasedCollator
extends Collator

RuleBasedCollator class является конкретным подклассом Collator это обеспечивает простую, управляемую данными, табличную сортировально-подборочную машину. С этим class можно создать специализированное основанное на таблице Collator. RuleBasedCollator символы карт к ключам сортировки.

RuleBasedCollator имеет следующие ограничения для эффективности (другие подклассы могут использоваться для более сложных языков):

1. Если специальное правило сопоставления, которым управляют <модификатор>, определяется, это применяется к целому объекту сортировально-подборочной машины.
2. Все неупомянутые символы в конце порядка сопоставления.

Таблица сопоставления составляется из списка правил сопоставления, где каждое правило имеет одну из трех форм:

    <modifier>
    <relation> <text-argument>
    <reset> <text-argument>
 

Определения элементов правила следующие:

• Текстовый параметр: текстовым параметром является любая последовательность символов, исключая специальные символы (то есть, общие пробельные символы [0009-000D, 0020] и символы синтаксиса правила [0021-002F, 003A-0040, 005B-0060, 007B-007E]). Если те символы требуются, можно поместить их в одинарные кавычки (например, амперсанд => '&'). Отметьте, что закрывшие кавычки пробельные символы игнорируются; например. b c обрабатывается как bc.
• Модификатор: есть в настоящий момент два модификатора, которые включают специальные правила сопоставления.
  • : Включает Назад сортировку диакритических знаков (вторичные различия), как на французском языке.
  • '!': Включает тайский/Лаосский совместимый гласным свопинг. Если это правило находится в силе, когда тайский гласный диапазона \U0E40-\U0E44 предшествует тайскому согласному диапазона \U0E01-\U0E2E, ИЛИ лаосский гласный диапазона \U0EC0-\U0EC4 предшествует лаосскому согласному диапазона \U0E81-\U0EAE тогда, гласный помещается после согласного в целях сопоставления.

  : Указывает, что диакритические знаки сортируются назад, как на французском языке.

• Отношение: отношения являются следующим:
  • '<': Больше, как (основное) различие в букве
  • ';': Больше, как (вторичное) различие в диакритическом знаке
  • : Больше, как (третичное) различие в случае
  • '=': Равный
• Сброс: есть единственный сброс, который используется прежде всего для сокращений и расширений, но который может также использоваться, чтобы добавить модификацию в конце ряда правил.

  '&': Указывает, что следующее правило следует за позицией туда, где текстовый параметр сброса был бы сортирован.

Это звучит более сложным, чем это практически. Например, следующее эквивалентные способы выразить ту же самую вещь:

 a < b < c
 a < b & b < c
 a < c & a < b
 

Заметьте, что порядок важен, поскольку последующий элемент сразу идет после текстового параметра. Следующее не эквивалентно:

 a < b & a < c
 a < c & a < b
 

Или текстовый параметр должен уже присутствовать в последовательности, или некоторая начальная подстрока текстового параметра должна присутствовать. (например, "<b & один <e" допустимо, так как "a" присутствует в последовательности прежде, чем "один" будет сброшен). В этом последнем случае, "одном", не вводится и обрабатывается как единственный символ; вместо этого, "e" сортируется, как будто он был расширен до двух символов: сопровождаемый "e". Это различие появляется на естественных языках: в традиционном испанском "ch" обрабатывается, как если бы он сокращается к единственному символу (выраженный как "c <ch <d"), в то время как на традиционном немецком языке умляут обрабатывается, как если бы он расширился до двух символов (выраженный как "a, <b, B... &ae; \u00e3&AE; \u00c3"). [\u00e3 и \u00c3 являются, конечно, escape-последовательностями для умляута.]

Игнорируемые Символы

Для игнорируемых символов первое правило должно запуститься с отношения (примеры, которые мы использовали выше, действительно фрагменты; "<b" действительно должен быть" <<b"). Если, однако, первое отношение не" <", тогда все все текстовые параметры до первого" <" являются игнорируемыми. Например, ", - <<b" делает "-" игнорируемый символ, поскольку мы видели ранее в слове "черных дроздов". В выборках для различных языков Вы видите, что большинство диакритических знаков является игнорируемым.

Нормализация и Диакритические знаки

RuleBasedCollator автоматически обрабатывает его таблицу правила, чтобы включать и версии предварительно составленного и комбинированного символа символов с диакритическим знаком. Даже если обеспеченная строка правила будет содержать только базовые символы и отдельные символы с диакритикой объединения, то предсоставленные символы с диакритическим знаком, соответствующие все канонические комбинации символов от строки правила, будут вводиться в таблицу.

Это позволяет Вам использовать RuleBasedCollator, чтобы сравнить акцентируемые строки, даже когда сортировально-подборочная машина устанавливается в NO_DECOMPOSITION. Есть два протеста, как бы то ни было. Во-первых, если строки, которые будут сопоставлены, содержат объединяющиеся последовательности, которые, возможно, не находятся в каноническом порядке, следует установить сортировально-подборочную машину в CANONICAL_DECOMPOSITION или FULL_DECOMPOSITION, чтобы позволить сортировать объединяющихся последовательностей. Во-вторых, если строки содержат символы с разложениями совместимости (такой как полный-width и формы half-width), следует использовать FULL_DECOMPOSITION, так как таблицы правила только включают канонические отображения.

Ошибки

Следующее является ошибками:

• Текстовый параметр содержит закрывшие кавычки символы пунктуации (например, "<b-c <d").
• Отношение или символ сброса, не сопровождаемый текстовым параметром (например, "<, b").
• Сброс, где текстовый параметр (или начальная подстрока текстового параметра) уже не находится в последовательности. (например, "<b & e <f")

Если Вы производите одну из этих ошибок, a RuleBasedCollator броски a ParseException.

Примеры

Простой:" <<b <c <d"

Норвежский язык:" <a, <b, B <c, C <d, D <e, E <f, F <г, Г <h, H <я, я <j, J <k, K <l, L <м., М. <n, N <o, O <p, P <q, Q <r, R <s, S <t, T <u, U <v, V <w, W <x, X <y, Y <z, Z <\u00E6, \u00C6 <\u00F8, \u00D8 <\u00E5 = a\u030A, \u00C5 = A\u030A; aa, AA"

Создать a RuleBasedCollator объект со специализированными правилами, адаптированными в соответствии с Вашими потребностями, Вы создаете RuleBasedCollator с правилами, содержавшимися в a String объект. Например:

 String simple = "< a< b< c< d";
 RuleBasedCollator mySimple = new RuleBasedCollator(simple);
 

Или:

 String Norwegian = "< a, A < b, B < c, C < d, D < e, E < f, F < g, G < h, H < i, I" +
                    "< j, J < k, K < l, L < m, M < n, N < o, O < p, P < q, Q < r, R" +
                    "< s, S < t, T < u, U < v, V < w, W < x, X < y, Y < z, Z" +
                    "< \u00E6, \u00C6" +     // Latin letter ae & AE
                    "< \u00F8, \u00D8" +     // Latin letter o & O with stroke
                    "< \u00E5 = a\u030A," +  // Latin letter a with ring above
                    "  \u00C5 = A\u030A;" +  // Latin letter A with ring above
                    "  aa, AA";
 RuleBasedCollator myNorwegian = new RuleBasedCollator(Norwegian);
 

Новое сопоставление постановляет, что строка может быть создана, связывая строки правил. Например, правила, возвращенные getRules() мог быть связан, чтобы объединиться многократный RuleBasedCollators.

Следующий пример демонстрирует, как изменить порядок диакритических знаков без интервалов,

 // old rule
 String oldRules = "=\u0301;\u0300;\u0302;\u0308"    // main accents
                 + ";\u0327;\u0303;\u0304;\u0305"    // main accents
                 + ";\u0306;\u0307;\u0309;\u030A"    // main accents
                 + ";\u030B;\u030C;\u030D;\u030E"    // main accents
                 + ";\u030F;\u0310;\u0311;\u0312"    // main accents
                 + "< a , A ; ae, AE ; \u00e6 , \u00c6"
                 + "< b , B < c, C < e, E & C < d, D";
 // change the order of accent characters
 String addOn = "& \u0300 ; \u0308 ; \u0302";
 RuleBasedCollator myCollator = new RuleBasedCollator(oldRules + addOn);
 

См. Также:

Collator, CollationElementIterator

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

Поля, наследованные от class java.text. Сортировально-подборочная машина

CANONICAL_DECOMPOSITION, FULL_DECOMPOSITION, IDENTICAL, NO_DECOMPOSITION, PRIMARY, SECONDARY, TERTIARY

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

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

Конструктор и Описание
RuleBasedCollator(String rules) Конструктор RuleBasedCollator.

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

Модификатор и Тип	Метод и Описание
Объект	clone() Стандартное переопределение; никакое изменение в семантике.
int	compare(String source, String target) Сравнивает символьные данные, хранившие в двух различных строках, основанных на правилах сопоставления.
boolean	equals(Object obj) Сравнивает равенство двух объектов сопоставления.
CollationElementIterator	getCollationElementIterator(CharacterIterator source) Возвратите CollationElementIterator для данной Строки.
CollationElementIterator	getCollationElementIterator(String source) Возвратите CollationElementIterator для данной Строки.
CollationKey	getCollationKey(String source) Преобразовывает строку в серию символов, которые могут быть по сравнению с CollationKey.compareTo.
Строка	getRules() Получает основанные на таблице правила для объекта сопоставления.
int	hashCode() Генерирует хэш-код для основанного на таблице объекта сопоставления

Методы, наследованные от class java.text. Сортировально-подборочная машина

compare, equals, getAvailableLocales, getDecomposition, getInstance, getInstance, getStrength, setDecomposition, setStrength

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

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

Методы, наследованные от интерфейса java.util. Компаратор

reverseOrder, thenComparing, thenComparing, thenComparing, thenComparing, thenComparing

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

RuleBasedCollator

public RuleBasedCollator(String rules)
                  throws ParseException

Конструктор RuleBasedCollator. Это берет табличные правила и создает таблицу сопоставления из них. Пожалуйста, см. RuleBasedCollator описание class для большего количества деталей о синтаксисе правила сопоставления.

Параметры:

rules - сопоставление управляет, чтобы создать таблицу сопоставления из.

Броски:

ParseException - Исключение формата будет выдано, если процесс сборки правил перестанет работать. Например, создайте правило "a < ? < d" will cause the constructor to throw the ParseException because the '?' is not quoted.

См. Также:

Locale

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

getRules

public String getRules()

Получает основанные на таблице правила для объекта сопоставления.

Возвраты:

возвращается сопоставление постановляет, что табличный объект сопоставления создавался из.

getCollationElementIterator

public CollationElementIterator getCollationElementIterator(String source)

Возвратите CollationElementIterator для данной Строки.

См. Также:

CollationElementIterator

getCollationElementIterator

public CollationElementIterator getCollationElementIterator(CharacterIterator source)

Возвратите CollationElementIterator для данной Строки.

С тех пор:

1.2

См. Также:

CollationElementIterator

сравниться

public int compare(String source,
                   String target)

Сравнивает символьные данные, хранившие в двух различных строках, основанных на правилах сопоставления. Информация о возвратах о том, является ли строка меньше чем, больше чем или равный другой строке на языке. Это может быть overriden в подклассе.

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

compare в class Collator

Параметры:

source - исходная строка.

target - целевая строка.

Возвраты:

Возвращает целочисленное значение. Значение является меньше чем нуль, если источник является меньше чем цель, значение является нулем, если источник и цель равен, значение больше чем нуль, если источник больше чем цель.

Броски:

NullPointerException - если source или target нуль.

См. Также:

CollationKey, Collator.getCollationKey(java.lang.String)

getCollationKey

public CollationKey getCollationKey(String source)

Преобразовывает строку в серию символов, которые могут быть по сравнению с CollationKey.compareTo. Это переопределяет java.text. Collator.getCollationKey. Это может быть overriden в подклассе.

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

getCollationKey в class Collator

Параметры:

source - строка, которая будет преобразована в ключ сопоставления.

Возвраты:

CollationKey для данной Строки, основанной на правилах сопоставления этой Сортировально-подборочной машины. Если исходная Строка является нулем, нулевой CollationKey возвращается.

См. Также:

CollationKey, Collator.compare(java.lang.String, java.lang.String)

клон

public Object clone()

Стандартное переопределение; никакое изменение в семантике.

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

clone в class Collator

Возвраты:

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

См. Также:

Cloneable

равняется

public boolean equals(Object obj)

Сравнивает равенство двух объектов сопоставления.

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

equals в интерфейсе Comparator<Object>

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

equals в class Collator

Параметры:

obj - основанное на таблице сопоставление возражает, чтобы быть по сравнению с этим.

Возвраты:

истина, если текущий основанный на таблице объект сопоставления является тем же самым как основанным на таблице сопоставлением, возражает obj; ложь иначе.

См. Также:

Object.hashCode(), HashMap

хэш-код

public int hashCode()

Генерирует хэш-код для основанного на таблице объекта сопоставления

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

hashCode в class Collator

Возвраты:

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

См. Также:

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