JavaTM Platform
Standard Ed. 6

java.text
クラス CollationKey

java.lang.Object
  上位を拡張 java.text.CollationKey
すべての実装されたインタフェース:
Comparable<CollationKey>

public abstract class CollationKey
extends Object
implements Comparable<CollationKey>

CollationKey は、特定の Collator オブジェクトのルールのもとにある String を表します。2 つの CollationKey を比較すると、それらが表す String の相対順序が返されます。CollationKey を使用して String を比較する方が一般に Collator.compare よりも高速です。したがって、複数の String を何回も比較する場合 (たとえば、String のリストをソートする場合) には、CollationKey を使う方が効率的です。

CollationKey を直接作成することはできません。それらを生成するには、Collator.getCollationKey を呼び出す必要があります。CollationKey を比較する場合、それらは同じ Collator オブジェクトから生成しなければなりません。

StringCollationKey を生成するためには、String 全体を調べ、それを、ビット単位で比較できるビット列に変換する必要があります。こうすると、キーが生成されたあとで、比較が高速に行われます。キーを生成するコストは、String を何回も比較する必要がある場合には、高速な比較によって埋め合せることができます。一方、比較の結果は、それぞれの String の最初の 2 文字で決まることがよくあります。Collator.compare では、必要な文字数だけが比較されるので、単一の比較ではこの方が高速です。  

次の例は、CollationKey を使って、String のリストをソートする場合を示したものです。

 // 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 と比較します。
 String getSourceString()
          この CollationKey が表す String を返します。
abstract  byte[] toByteArray()
          CollationKey をビット列に変換します。
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

CollationKey

protected CollationKey(String source)
CollationKey のコンストラクタです。

パラメータ:
source - - ソース文字列
例外:
NullPointerException - source が null の場合
導入されたバージョン:
1.6
メソッドの詳細

compareTo

public abstract int compareTo(CollationKey target)
この CollationKey をターゲットの CollationKey と比較します。これらのキーを作成した Collator オブジェクトの照合ルールが適用されます。注:異なる Collator で作成した CollationKey は比較できません。

定義:
インタフェース Comparable<CollationKey> 内の compareTo
パラメータ:
target - ターゲットの CollationKey
戻り値:
整数値。これがターゲットより小さければ、値はゼロより小さい。 これがターゲットと等しければ、値はゼロ。 これがターゲットより大きければ、値はゼロより大きい
関連項目:
Collator.compare(java.lang.String, java.lang.String)

getSourceString

public String getSourceString()
この CollationKey が表す String を返します。


toByteArray

public abstract byte[] toByteArray()
CollationKey をビット列に変換します。2 つの CollationKey が正しく比較できる場合は、これらの配列のそれぞれに対するバイト配列を比較しても同じ結果が得られます。バイト配列では、もっとも大きなバイトが最初にあります。


JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。