模块  java.base
软件包  java.text

Class CollationKey

  • 实现的所有接口
    Comparable<CollationKey>

    public abstract class CollationKey
    extends Object
    implements 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仅检查所需的字符数,这样可以在进行单次比较时更快。

    以下示例显示了如何使用CollationKeyString的列表进行排序。

    
     // 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
    另请参见:
    CollatorRuleBasedCollator
    • 构造方法详细信息

      • 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的字节数组表示形式