Package blbutil

Class UnsignedByteArray

java.lang.Object

blbutil.UnsignedByteArray

All Implemented Interfaces:

IntArray

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

Class ShiftedByteIndexArray represents an immutable array of integer values between 0 and 255 inclusive that is stored as a byte[] array whose values have been translated by -128.

Instances of UnsignedByteArray are immutable.

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
int	get(int index)	Returns the specified array element.
int	max()	Returns the maximum element, or Integer.MIN_VALUE if this.size() == 0.
int	min()	Returns the minimum element, or Integer.MAX_VALUE if this.size() == 0.
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

Methods inherited from class java.lang.Object

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

Constructor Detail

UnsignedByteArray

public UnsignedByteArray(byte[] ba)

Constructs a new UnsignedByteArray instance from the specified data.

Parameters:

ba - an array of bytes which are interpreted as unsigned byte values between 0 and 255

Throws:

java.lang.NullPointerException - if ba == null

UnsignedByteArray

public UnsignedByteArray(byte[] ba,
                         int from,
                         int to)

Constructs a new UnsignedByteArray instance from the specified data.

Parameters:

ba - an array of bytes which are interpreted as unsigned byte values between 0 and 255

from - the first element to be included (inclusive)

to - the last element to be included (exclusive)

Throws:

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

java.lang.NegativeArraySizeException - if to > from

java.lang.NullPointerException - if ba == null

UnsignedByteArray

public UnsignedByteArray(int[] ia)

Constructs a new UnsignedByteArray instance from the specified data.

Parameters:

ia - an array of positive integer values whose lower order byte will be stored

Throws:

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

java.lang.NullPointerException - if ia == null

UnsignedByteArray

public UnsignedByteArray(IntList il)

Constructs a new UnsignedByteArray instance from the specified data.

Parameters:

il - an list of integer values between 0 and 255 inclusive

Throws:

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

java.lang.NullPointerException - if il == null

UnsignedByteArray

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

Constructs a new UnsignedByteArray instance from the specified data.

Parameters:

ia - an array of integer values between 0 and 255 inclusive

from - the first element to be included (inclusive)

to - the last element to be included (exclusive)

Throws:

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

UnsignedByteArray

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

Constructs a new UnsignedByteArray instance from the specified data.

Parameters:

il - an list of integer values between 0 and 255 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) > 255) 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

max

public int max()

Description copied from interface: IntArray

Returns the maximum element, or Integer.MIN_VALUE if this.size() == 0.

Specified by:

max in interface IntArray

Returns:

the maximum element

min

public int min()

Description copied from interface: IntArray

Returns the minimum element, or Integer.MAX_VALUE if this.size() == 0.

Specified by:

min in interface IntArray

Returns:

the minimum element