Package blbutil

Interface IntArray

All Known Implementing Classes:

ByteArray, CharArray, UnsignedByteArray, WrappedIntArray

public interface IntArray

Interface IntArray represents an immutable int[] array.

Instances of class IntArray are required to be immutable.

Method Summary

Modifier and Type	Method	Description
default java.lang.String	asString()	Returns a string representation of this IntArray by applying java.utils.Arrays.toString() to an equivalent int[] object.
static IntArray	create(int[] ia, int start, int end)	Returns a new IntArray instance that has the same sequence of integers as the specified array.
static IntArray	create(IntList il, int start, int end)	Returns a new IntArray instance that has the same sequence of integers as the specified list.
int	get(int index)	Returns the specified array element.
default int	max()	Returns the maximum element, or Integer.MIN_VALUE if this.size() == 0.
default 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.

Method Detail

size

int size()

Returns the number of elements in this IntArray.

Returns:

the number of elements in this IntArray

get

int get(int index)

Returns the specified array element.

Parameters:

index - an array index

Returns:

the specified array element

Throws:

java.lang.IndexOutOfBoundsException - if index < 0 || index >= this.size()

max

default int max()

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

Returns:

the maximum element

min

default int min()

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

Returns:

the minimum element

toString

java.lang.String toString()

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

Overrides:

toString in class java.lang.Object

Returns:

a string representation of this IntArray

asString

default java.lang.String asString()

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

Returns:

a string representation of this IntArray.

create

static IntArray create(int[] ia,
                       int start,
                       int end)

Returns a new IntArray instance that has the same sequence of integers as the specified array.

Parameters:

ia - the array of integers to be copied

start - the exclusive start of an interval containing the values in the array

end - the exclusive end of an interval containing the values in the array

Returns:

a new IntArray instance that has the same sequence of integers as the specified array

Throws:

java.lang.IllegalArgumentException - if start >= end

java.lang.IllegalArgumentException - if an out-of-range element is detected

java.lang.NullPointerException - if ia == null

create

static IntArray create(IntList il,
                       int start,
                       int end)

Returns a new IntArray instance that has the same sequence of integers as the specified list.

Parameters:

il - the list of integers to be copied

start - the exclusive start of an interval containing the values in the list

end - the exclusive end of an interval containing the values in the list

Returns:

a new IntArray instance that has the same sequence of integers as the specified list

Throws:

java.lang.IllegalArgumentException - if start >= end

java.lang.IllegalArgumentException - if an out-of-range element is detected

java.lang.NullPointerException - if il == null