Package blbutil

Class CharArray

java.lang.Object

blbutil.CharArray

All Implemented Interfaces:

IntArray

public final class CharArray
extends java.lang.Object
implements IntArray

/**

Class UnsignedByteArray represents an immutable array of integer values between 0 and 65,535 inclusive that is stored as a char[] array.

Instances of CharArray are immutable.

Constructor Summary

Constructors

Constructor	Description
CharArray(byte[] ba)	Constructs a new CharArray instance from the specified data.
CharArray(char[] ca)	Constructs a new CharArray instance from the specified data.
CharArray(int[] ia)	Constructs a new CharArray instance from the specified data.
CharArray(int[] ia, int to, int from)	Constructs a new CharArray instance from the specified data.
CharArray(IntList il)	Constructs a new UnsignedByteArray instance from the specified data.
CharArray(IntList il, int from, int to)	Constructs a new CharArray instance from the specified data.

Method Summary

Modifier and Type	Method	Description
int	get(int index)	Returns the specified array element.
int	size()	Returns the number of elements in this IntArray.
java.lang.String	toString()	Returns a string representation of this IntArray by applying java.utils.Arrays.toString() to an equivalent int[] object.

Methods inherited from interface blbutil.IntArray

asString, max, min

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

CharArray

public CharArray(byte[] ba)

Constructs a new CharArray instance from the specified data. The array of bytes is interpreted as a stream of characters with the high byte preceding the low byte.

Parameters:

ba - an array of char values expressed as pairs of bytes.

Throws:

java.lang.IllegalArgumentException - if (ba.length % 1) != 0

java.lang.NullPointerException - if ca == null

CharArray

public CharArray(char[] ca)

Constructs a new CharArray instance from the specified data.

Parameters:

ca - an array of integer values between 0 and Character.MAX_VALUE inclusive

Throws:

java.lang.NullPointerException - if ca == null

CharArray

public CharArray(int[] ia)

Constructs a new CharArray instance from the specified data.

Parameters:

ia - an array of integers

Throws:

java.lang.IllegalArgumentException - if (ia[j] < 0 || ia[j] > Character.MAX_VALUE) for any index j satisfying (j >= from && j < to)

java.lang.NullPointerException - if ia == null

CharArray

public CharArray(IntList il)

Constructs a new UnsignedByteArray instance from the specified data.

Parameters:

il - an list of integer values between 0 and Character.MAX_VALUE inclusive

Throws:

java.lang.IllegalArgumentException - if (il.get(j) < 0 || il.get(j) > Character.MAX_VALUE) for any index j satisfying (j >= 0 && j < il.size())

java.lang.NullPointerException - if il == null

CharArray

public CharArray(int[] ia,
                 int to,
                 int from)

Constructs a new CharArray instance from the specified data.

Parameters:

ia - an array of integer values between 0 and Character.MAX_VALUE inclusive

to - the first element to be included (inclusive)

from - the last element to be included (exclusive)

Throws:

java.lang.IllegalArgumentException - if (ia[j] < 0 || ia[j] > Character.MAX_VALUE) for any index j satisfying (j >= from && j < to)

java.lang.IndexOutOfBoundsException - if (from < 0 || to > ia.length)

java.lang.NegativeArraySizeException - if to > from

java.lang.NullPointerException - if ia == null

CharArray

public CharArray(IntList il,
                 int from,
                 int to)

Constructs a new CharArray instance from the specified data.

Parameters:

il - an list of integer values between 0 and Character.MAX_VALUE inclusive

from - the first element to be included (inclusive)

to - the last element to be included (exclusive)

Throws:

java.lang.IllegalArgumentException - if (il.get(j) < 0 || il.get(j) > Character.MAX_VALUE) for any index j satisfying (j >= from && j < to)

java.lang.IndexOutOfBoundsException - if from < 0 || to > il.length

java.lang.NegativeArraySizeException - if to > from

java.lang.NullPointerException - if il == null

Method Detail

size

public int size()

Description copied from interface: IntArray

Returns the number of elements in this IntArray.

Specified by:

size in interface IntArray

Returns:

the number of elements in this IntArray

get

public int get(int index)

Description copied from interface: IntArray

Returns the specified array element.

Specified by:

get in interface IntArray

Parameters:

index - an array index

Returns:

the specified array element

toString

public java.lang.String toString()

Description copied from interface: IntArray

Returns a string representation of this IntArray by applying java.utils.Arrays.toString() to an equivalent int[] object.

Specified by:

toString in interface IntArray

Overrides:

toString in class java.lang.Object

Returns:

a string representation of this IntArray