blbutil

Class IntList

java.lang.Object

blbutil.IntList

public class IntList
extends java.lang.Object

Class IntList represents a list of integers. Class IntList supports a clear() method, but it does not support a remove() method.

Class IntList is not thread-safe.

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_INIT_CAPACITY The default initial capacity of an IntList, which is 10.

Constructor Summary

Constructors

Constructor and Description
IntList() Constructs an IntList object with the default initial capacity.
IntList(int initCapacity) Constructs an IntList object with the specified initial capacity.

Method Summary

Modifier and Type	Method and Description
void	add(int element) Adds the specified integer to the end of this list.
void	clear() Removes all elements from this list.
int	decrementAndGet(int index) Decrements by one the element at the specified position in this list.
int	get(int index) Returns the element at the specified position in this list.
int	getAndDecrement(int index) Decrements by one the element at the specified position in this list.
int	getAndIncrement(int index) Increments by one the element at the specified position in this list.
int	incrementAndGet(int index) Increments by one the element at the specified position in this list.
boolean	isEmpty() Returns true if this list has no elements, and returns false otherwise.
int	set(int index, int element) Replaces the element at the specified position in this list with the specified element.
int	size() Returns the number of elements in this list.
int[]	toArray() Returns an integer array containing the sequence of elements in this list.
java.lang.String	toString() Returns java.util.Arrays.toString(this.toArray())

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_INIT_CAPACITY

public static final int DEFAULT_INIT_CAPACITY

The default initial capacity of an IntList, which is 10.

See Also:

Constant Field Values

Constructor Detail

IntList

public IntList()

Constructs an IntList object with the default initial capacity.

See Also:

DEFAULT_INIT_CAPACITY

IntList

public IntList(int initCapacity)

Constructs an IntList object with the specified initial capacity.

Parameters:

initCapacity - the initial capacity of this list

Throws:

java.lang.IllegalArgumentException - if initCapacity < 0

Method Detail

get

public int get(int index)

Returns the element at the specified position in this list.

Parameters:

index - the index of the element to be returned

Returns:

the element at the specified position in this list

Throws:

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

set

public int set(int index,
               int element)

Replaces the element at the specified position in this list with the specified element.

Parameters:

index - the index of the element to be replaced

element - the element to be stored at the specified position in this list

Returns:

the previous element at the specified position in this list

Throws:

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

getAndIncrement

public int getAndIncrement(int index)

Increments by one the element at the specified position in this list.

Parameters:

index - the index of the element to be incremented

Returns:

the previous element at the specified position in this list

Throws:

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

getAndDecrement

public int getAndDecrement(int index)

Decrements by one the element at the specified position in this list.

Parameters:

index - the index of the element to be decremented

Returns:

the previous element at the specified position in this list

Throws:

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

incrementAndGet

public int incrementAndGet(int index)

Increments by one the element at the specified position in this list.

Parameters:

index - the index of the element to be incremented

Returns:

the updated element at the specified position in this list

Throws:

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

decrementAndGet

public int decrementAndGet(int index)

Decrements by one the element at the specified position in this list.

Parameters:

index - the index of the element to be decremented

Returns:

the updated element at the specified position in this list

Throws:

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

size

public int size()

Returns the number of elements in this list.

Returns:

the number of elements in this list

isEmpty

public boolean isEmpty()

Returns true if this list has no elements, and returns false otherwise.

Returns:

true if this list has no elements

toArray

public int[] toArray()

Returns an integer array containing the sequence of elements in this list.

Returns:

an integer array containing the sequence of elements in this list

add

public void add(int element)

Adds the specified integer to the end of this list.

Parameters:

element - the integer to be added to the end of this list

clear

public void clear()

Removes all elements from this list.

toString

public java.lang.String toString()

Returns java.util.Arrays.toString(this.toArray())

Overrides:

toString in class java.lang.Object

Returns:

java.util.Arrays.toString(this.toArray())