1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
|
/* GENERATED SOURCE. DO NOT MODIFY. */
/**
*******************************************************************************
* Copyright (C) 1996-2010, International Business Machines Corporation and *
* others. All Rights Reserved. *
*******************************************************************************
*/
package android.icu.text;
import android.icu.util.ByteArrayWrapper;
/**
* <p>
* Simple class wrapper to store the internal byte representation of a
* CollationKey. Unlike the CollationKey, this class do not contain information
* on the source string the sort order represents. RawCollationKey is mutable
* and users can reuse its objects with the method in
* RuleBasedCollator.getRawCollationKey(..).
* </p>
* <p>
* Please refer to the documentation on CollationKey for a detail description
* on the internal byte representation. Note the internal byte representation
* is always null-terminated.
* </p>
* <code>
* Example of use:<br>
* String str[] = {.....};
* RuleBasedCollator collator = (RuleBasedCollator)Collator.getInstance();
* RawCollationKey key = new RawCollationKey(128);
* for (int i = 0; i < str.length; i ++) {
* collator.getRawCollationKey(str[i], key);
* // do something with key.bytes
* }
* </code>
* <p><strong>Note:</strong> Comparison between RawCollationKeys created by
* different Collators might return incorrect results.
* See class documentation for Collator.</p>
* @see RuleBasedCollator
* @see CollationKey
*/
public final class RawCollationKey extends ByteArrayWrapper
{
// public constructors --------------------------------------------------
/**
* Default constructor, internal byte array is null and its size set to 0.
*/
public RawCollationKey()
{
}
/**
* RawCollationKey created with an empty internal byte array of length
* capacity. Size of the internal byte array will be set to 0.
* @param capacity length of internal byte array
*/
public RawCollationKey(int capacity)
{
bytes = new byte[capacity];
}
/**
* RawCollationKey created, adopting bytes as the internal byte array.
* Size of the internal byte array will be set to 0.
* @param bytes byte array to be adopted by RawCollationKey
*/
public RawCollationKey(byte[] bytes)
{
this.bytes = bytes;
}
/**
* Construct a RawCollationKey from a byte array and size.
* @param bytesToAdopt the byte array to adopt
* @param size the length of valid data in the byte array
* @throws IndexOutOfBoundsException if bytesToAdopt == null and size != 0, or
* size < 0, or size > bytesToAdopt.length.
*/
public RawCollationKey(byte[] bytesToAdopt, int size)
{
super(bytesToAdopt, size);
}
/**
* Compare this RawCollationKey to another, which must not be null. This overrides
* the inherited implementation to ensure the returned values are -1, 0, or 1.
* @param rhs the RawCollationKey to compare to.
* @return -1, 0, or 1 as this compares less than, equal to, or
* greater than rhs.
* @throws ClassCastException if the other object is not a RawCollationKey.
*/
public int compareTo(RawCollationKey rhs) {
int result = super.compareTo(rhs);
return result < 0 ? -1 : result == 0 ? 0 : 1;
}
}
|
