模块  java.base
软件包  java.text

Class CollationKey

  • 实现的所有接口
    Comparable<CollationKey> 
    public abstract class CollationKeyextends Objectimplements Comparable<CollationKey>
    甲CollationKey表示String下一个特定的规则Collator对象。 比较两个CollationKey s将返回它们所代表的String的相对顺序。 使用CollationKey s比较String s通常比使用Collator.compare更快。 因此，当必须多次比较String时，例如在排序String的列表时。 使用CollationKey更有效。

    您无法直接创建CollationKey 。 而是通过调用Collator.getCollationKey生成它们。 只能比较CollationKey来自同一生成S- Collator对象。

    为CollationKey生成String涉及检查整个String并将其转换为可逐位比较的一系列位。 这可以在生成密钥后进行快速比较。 当需要多次比较String时，可以更快地比较生成密钥的成本。 另一方面，比较的结果通常由每个String的前几个字符String 。 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());
    从以下版本开始：
    1.1
    另请参见：
    Collator ， RuleBasedCollator

    • 构造方法详细信息

      • CollationKey

        protected CollationKey​(String source)
        CollationKey构造函数。
        参数
        source - 源字符串
        异常
        NullPointerException - 如果 source为空
        从以下版本开始：
        1.6

    • 方法详细信息

      • compareTo

        public abstract int compareTo​(CollationKey target)
        将此CollationKey与目标CollationKey进行比较。 应用创建这些键的Collator对象的排序规则。 注意：无法比较由不同Collator创建的CollationKeys。
        Specified by:
        compareTo接口 Comparable<CollationKey>
        参数
        target - 目标CollationKey
        结果
        返回一个整数值。 如果此值小于目标值，则值小于零;如果此值和目标值相等，则值为零，如果此值大于目标值，则值大于零。
        另请参见：
        Collator.compare(java.lang.String, java.lang.String)

      • getSourceString

        public String getSourceString()
        返回此CollationKey表示的String。
        结果
        此CollationKey的源字符串

      • toByteArray

        public abstract byte[] toByteArray()
        将CollationKey转换为位序列。 如果可以合法地比较两个CollationKeys，则可以比较每个键的字节数组以获得相同的结果。 字节数组首先组织为最重要的字节。
        结果
        CollationKey的字节数组表示形式