Package blbutil

Class ByteArray

java.lang.Object

blbutil.ByteArray

All Implemented Interfaces:

IntArray

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

Class ByteArray represents an immutable array of integer values between -128 and 127 that is stored as a byte[] array.

Instances of ByteArray are immutable.

Constructor Summary

Constructors

Constructor	Description
ByteArray(byte[] ba)	Constructs a new ByteArray instance from the specified data.
ByteArray(int[] ia)	Constructs a new ByteArray instance from the specified data.
ByteArray(int[] ia, int from, int to)	Constructs a new ByteArray instance from the specified data.
ByteArray(IntList il)	Constructs a new ByteArray instance from the specified data.
ByteArray(IntList il, int from, int to)	Constructs a new ByteArray 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

ByteArray

public ByteArray(byte[] ba)

Constructs a new ByteArray instance from the specified data.

Parameters:

ba - an array of integer values between -128 and 127 inclusive

Throws:

java.lang.NullPointerException - if ba == null

ByteArray

public ByteArray(int[] ia)

Constructs a new ByteArray instance from the specified data.

Parameters:

ia - an array of integer values between -128 and 127 inclusive

Throws:

java.lang.IllegalArgumentException - if (ia[j] < -128 || ia[j] > 127) for any index j satisfying (j >= 0 && j < ia.length)

java.lang.NullPointerException - if ia == null

ByteArray

public ByteArray(IntList il)

Constructs a new ByteArray instance from the specified data.

Parameters:

il - an list of integer values between -128 and 127 inclusive

Throws:

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

java.lang.NullPointerException - if il == null

ByteArray

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

Constructs a new ByteArray instance from the specified data.

Parameters:

ia - an array of integer values between -128 and 127 inclusive

from - the first element to be included (inclusive)

to - the last element to be included (exclusive)

Throws:

java.lang.IllegalArgumentException - if (ia[j] < -128 || ia[j] > 127) 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

ByteArray

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

Constructs a new ByteArray instance from the specified data.

Parameters:

il - an list of integer values between -128 and 127 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) < -128 || il.get(j) > 127) 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