com.ibm.icu.util
Class CompactCharArray

java.lang.Object
  com.ibm.icu.util.CompactCharArray

All Implemented Interfaces:

Cloneable

Deprecated. This API is ICU internal only.

public final class CompactCharArray
extends Object
implements Cloneable

class CompactATypeArray : use only on primitive data types Provides a compact way to store information that is indexed by Unicode values, such as character properties, types, keyboard values, etc.This is very useful when you have a block of Unicode data that contains significant values while the rest of the Unicode data is unused in the application or when you have a lot of redundance, such as where all 21,000 Han ideographs have the same value. However, lookup is much faster than a hash table. A compact array of any primitive data type serves two purposes:

• Fast access of the indexed values.
• Smaller memory footprint.

A compact array is composed of a index array and value array. The index array contains the indicies of Unicode characters to the value array.

Author:

Helena Shih

See Also:

CompactByteArray

Status:

Internal. This API is ICU internal only.

Field Summary

static int	BLOCKSHIFT Deprecated. This API is ICU internal only.
static int	UNICODECOUNT Deprecated. This API is ICU internal only.

Constructor Summary

CompactCharArray()
Deprecated. This API is ICU internal only.

CompactCharArray(char defaultValue)
Deprecated. This API is ICU internal only.

CompactCharArray(char[] indexArray, char[] newValues)
Deprecated. This API is ICU internal only.

CompactCharArray(String indexArray, String valueArray)
Deprecated. This API is ICU internal only.

Method Summary

Object	clone() Deprecated. This API is ICU internal only.
void	compact() Deprecated. This API is ICU internal only.
void	compact(boolean exhaustive) Deprecated. This API is ICU internal only.
char	elementAt(char index) Deprecated. This API is ICU internal only.
boolean	equals(Object obj) Deprecated. This API is ICU internal only.
char[]	getIndexArray() Deprecated. This API is ICU internal only.
char[]	getValueArray() Deprecated. This API is ICU internal only.
int	hashCode() Deprecated. This API is ICU internal only.
void	setElementAt(char index, char value) Deprecated. This API is ICU internal only.
void	setElementAt(char start, char end, char value) Deprecated. This API is ICU internal only.

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail

UNICODECOUNT

public static final int UNICODECOUNT

Deprecated. This API is ICU internal only.

The total number of Unicode characters.

See Also:

Constant Field Values

Status:

Internal. This API is ICU internal only.

BLOCKSHIFT

public static final int BLOCKSHIFT

Deprecated. This API is ICU internal only.

See Also:

Constant Field Values

Status:

Internal. This API is ICU internal only.

Constructor Detail

CompactCharArray

public CompactCharArray()

Deprecated. This API is ICU internal only.

Default constructor for CompactCharArray, the default value of the compact array is 0.

Status:

Internal. This API is ICU internal only.

CompactCharArray

public CompactCharArray(char defaultValue)

Deprecated. This API is ICU internal only.

Constructor for CompactCharArray.

Parameters:

defaultValue - the default value of the compact array.

Status:

Internal. This API is ICU internal only.

CompactCharArray

public CompactCharArray(char[] indexArray,
                        char[] newValues)

Deprecated. This API is ICU internal only.

Constructor for CompactCharArray.

Parameters:

indexArray - the indicies of the compact array.

newValues - the values of the compact array.

Throws:

IllegalArgumentException - If the index is out of range.

Status:

Internal. This API is ICU internal only.

CompactCharArray

public CompactCharArray(String indexArray,
                        String valueArray)

Deprecated. This API is ICU internal only.

Constructor for CompactCharArray.

Parameters:

indexArray - the RLE-encoded indicies of the compact array.

valueArray - the RLE-encoded values of the compact array.

Throws:

IllegalArgumentException - if the index or value array is the wrong size.

Status:

Internal. This API is ICU internal only.

Method Detail

elementAt

public char elementAt(char index)

Deprecated. This API is ICU internal only.

Get the mapped value of a Unicode character.

Parameters:

index - the character to get the mapped value with

Returns:

the mapped value of the given character

Status:

Internal. This API is ICU internal only.

setElementAt

public void setElementAt(char index,
                         char value)

Deprecated. This API is ICU internal only.

Set a new value for a Unicode character. Set automatically expands the array if it is compacted.

Parameters:

index - the character to set the mapped value with

value - the new mapped value

Status:

Internal. This API is ICU internal only.

setElementAt

public void setElementAt(char start,
                         char end,
                         char value)

Deprecated. This API is ICU internal only.

Set new values for a range of Unicode character.

Parameters:

start - the starting offset of the range

end - the ending offset of the range

value - the new mapped value

Status:

Internal. This API is ICU internal only.

compact

public void compact()

Deprecated. This API is ICU internal only.

Compact the array

Status:

Internal. This API is ICU internal only.

compact

public void compact(boolean exhaustive)

Deprecated. This API is ICU internal only.

Compact the array.

Status:

Internal. This API is ICU internal only.

getIndexArray

public char[] getIndexArray()

Deprecated. This API is ICU internal only.

For internal use only. Do not modify the result, the behavior of modified results are undefined.

Status:

Internal. This API is ICU internal only.

getValueArray

public char[] getValueArray()

Deprecated. This API is ICU internal only.

For internal use only. Do not modify the result, the behavior of modified results are undefined.

Status:

Internal. This API is ICU internal only.

clone

public Object clone()

Deprecated. This API is ICU internal only.

Overrides Cloneable

Overrides:

clone in class Object

Status:

Internal. This API is ICU internal only.

equals

public boolean equals(Object obj)

Deprecated. This API is ICU internal only.

Compares the equality of two compact array objects.

Overrides:

equals in class Object

Parameters:

obj - the compact array object to be compared with this.

Returns:

true if the current compact array object is the same as the compact array object obj; false otherwise.

Status:

Internal. This API is ICU internal only.

hashCode

public int hashCode()

Deprecated. This API is ICU internal only.

Generates the hash code for the compact array object

Overrides:

hashCode in class Object

Status:

Internal. This API is ICU internal only.