java.text

Класс CollationKey

java.lang. Объект

java.text. CollationKey

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

Сопоставимый <CollationKey>

public abstract class CollationKey
extends Object
implements Comparable<CollationKey>

A CollationKey представляет a String по правилам определенного Collator объект. Сравнение два CollationKeys возвращает относительный порядок Strings они представляют. Используя CollationKeys, чтобы сравниться Strings обычно быстрее чем использование Collator.compare. Таким образом, когда Strings должен быть сравнен многократно, например сортируя список Strings. Более эффективно использовать CollationKeys.

Невозможно создать CollationKeys непосредственно. Скорее генерируйте их, вызывая Collator.getCollationKey. Можно только сравниться CollationKeys сгенерированный от того же самого Collator объект.

Генерирование a CollationKey для a String включает исследование всего String и преобразование этого к серии битов, которые могут быть сравнены порязрядно. Это позволяет быстрые сравнения, как только ключи сгенерированы. Стоимость генерирования ключей возмещается в более быстрых сравнениях когда Stringмного раз должен быть сравнен s. С другой стороны результат сравнения часто определяется первыми двумя символами каждого String. Collator.compare исследует только так много символов, как это нуждается, который позволяет этому быть быстрее, делая единственные сравнения.

Следующий пример показывает как CollationKeys мог бы использоваться, чтобы сортировать список Strings.

 // Create an array of CollationKeys for the Strings to be sorted.
 Collator myCollator = Collator.getInstance();
 CollationKey[] keys = new CollationKey[3];
 keys[0] = myCollator.getCollationKey("Tom");
 keys[1] = myCollator.getCollationKey("Dick");
 keys[2] = myCollator.getCollationKey("Harry");
 sort( keys );
 

 //...
 

 // Inside body of sort routine, compare keys this way
 if( keys[i].compareTo( keys[j] ) > 0 )
    // swap keys[i] and keys[j]
 

 //...
 

 // Finally, when we've returned from sort.
 System.out.println( keys[0].getSourceString() );
 System.out.println( keys[1].getSourceString() );
 System.out.println( keys[2].getSourceString() );
 

См. Также:

Collator, RuleBasedCollator

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

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

Модификатор	Конструктор и Описание
protected	CollationKey(String source) Конструктор CollationKey.

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

Методы

Модификатор и Тип	Метод и Описание
abstract int	compareTo(CollationKey target) Сравните этот CollationKey с целевым CollationKey.
Строка	getSourceString() Возвращает Строку, которую представляет этот CollationKey.
abstract byte[]	toByteArray() Преобразовывает CollationKey в последовательность битов.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

CollationKey

protected CollationKey(String source)

Конструктор CollationKey.

Параметры:

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

Броски:

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

С тех пор:

1.6

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

compareTo

public abstract int compareTo(CollationKey target)

Сравните этот CollationKey с целевым CollationKey. Правила сопоставления объекта Сортировально-подборочной машины, который создал эти ключи, применяются. Отметьте: CollationKeys, создаваемый различными Сортировально-подборочными машинами, не может быть сравнен.

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

compareTo в интерфейсе Comparable<CollationKey>

Параметры:

target - целевой CollationKey

Возвраты:

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

См. Также:

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

getSourceString

public String getSourceString()

Возвращает Строку, которую представляет этот CollationKey.

toByteArray

public abstract byte[] toByteArray()

Преобразовывает CollationKey в последовательность битов. Если два CollationKeys могли бы быть законно сравнены, то можно было сравнить байтовые массивы для каждого из тех ключей, чтобы получить тот же самый результат. Байтовые массивы организуются старший значащий байт сначала.