goodslib
Class ArrayOfInt

java.lang.Object
  |
  +--goodsjpi.Persistent
        |
        +--goodslib.AnyArray
              |
              +--goodslib.ArrayOfInt

public class ArrayOfInt

extends AnyArray

ArrayOfInt is just that, an array of ints. It is fully persistent, as it it's derived from Persistent. All reads cause a fetch of the data, all writes mark it dirty and to be saved.

Field Summary

protected int[]

array array holds the ints in an []

Fields inherited from class goodslib.AnyArray

used

Fields inherited from class goodsjpi.Persistent

defaultMetaobject, metaobject

Constructor Summary

ArrayOfInt(int size)
Creates a new ArrayOfInt instance.

ArrayOfInt(int[] src)
Creates a new ArrayOfInt instance, as a copy of the given int[]

ArrayOfInt(int size, int allocatedSize)
Creates a new ArrayOfInt instance.

Method Summary

void	append(int[] tail) append add the given values to the end of the array
void	changeSize(int newSize) Resize the amount of space taken by the array.
void	copy(int dstIndex, int[] src, int srcIndex, int count) copy into this array from a destination, a given amount of values.
int	getAt(int index) Get a int at the specified index
int	indexOf(int val) indexOf returns the first occurrence of val
void	insert(int index, int count, int value) insert a "count" amount of values at a given index.
int	lastIndexOf(int val) Find the lastIndexOf a given value
int	pop() Use the array as a stack and pop a value.
void	push(int value) Use the array as a stack with the push method.
void	putAt(int index, int value) Put a int value at a given index
void	remove(int index, int count) remove a number of values.
int[]	toArray() toArray converts the internal representation to a int[] , of correct size.
int	top() Check the top boolean with the top method.

Methods inherited from class goodslib.AnyArray

length

Methods inherited from class goodsjpi.Persistent

attachToStorage, clone, clusterWith, finalize, getDatabase, getOid, getStorageId, hashCode

Methods inherited from class java.lang.Object

equals, getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail

array

protected int[] array

array holds the ints in an []

Constructor Detail

ArrayOfInt

public ArrayOfInt(int size)

Creates a new ArrayOfInt instance.

Parameters:

size - is the initial size, (length)

ArrayOfInt

public ArrayOfInt(int size,
                  int allocatedSize)

Creates a new ArrayOfInt instance. (Full of false)

Parameters:

size - , or length of the array

allocatedSize - is the size it can grow to without re-sizing

ArrayOfInt

public ArrayOfInt(int[] src)

Creates a new ArrayOfInt instance, as a copy of the given int[]

Parameters:

src - a int[] that will be copied

Method Detail

putAt

public void putAt(int index,
                  int value)

Put a int value at a given index

Parameters:

index - an int value, where the value should be set

value - the int value to be set

getAt

public int getAt(int index)

Get a int at the specified index

Parameters:

index - of the int you want

Returns:

a int value, at index "index"

changeSize

public void changeSize(int newSize)

Resize the amount of space taken by the array. Either grow or shrink as necessary. You get an IndexOutOfBoundException for negative values.
of course the old data is copied.

Parameters:

newSize - an int denoting the new size.

insert

public void insert(int index,
                   int count,
                   int value)

insert a "count" amount of values at a given index. Throws an IndexOutOfBoundsException for too small (<0) or too big (>length) count or index.

Parameters:

index - , where to start inserting value(s)

count - , how many values to insert

value - a int value to insert

remove

public void remove(int index,
                   int count)

remove a number of values. The array shrinks in it's length, but no resizing is done. Get an IndexOutOfBoundsException for inappropriate index or count values.

Parameters:

index - , where to start removing

count - , how many values to remove

push

public void push(int value)

Use the array as a stack with the push method.

Parameters:

value - , a int to push to the stack

pop

public int pop()

Use the array as a stack and pop a value. (Value is removed) IndexOutOfBoundsExceptions comes when array has hit 0 length.

Returns:

the top most int value

top

public int top()

Check the top boolean with the top method. This returns what pop returns, just it doesn't remove the value. In other stack implementations it may be called peek()

Returns:

a int value

append

public void append(int[] tail)

append add the given values to the end of the array

Parameters:

tail - a int[] that will be appended

toArray

public int[] toArray()

toArray converts the internal representation to a int[] , of correct size. Ie: the .length of the return == this.size()

Returns:

a int[] value

copy

public void copy(int dstIndex,
                 int[] src,
                 int srcIndex,
                 int count)

copy into this array from a destination, a given amount of values. Get a IndexOutOfBounds if the src or count don't fit

Parameters:

dstIndex - , the index (of this array) where to copy to

src - a int[] , where to copy from

srcIndex - an int , where to start copying from

count - an int , how many values to copy

indexOf

public int indexOf(int val)

indexOf returns the first occurrence of val

Parameters:

val - a int to be looked for

Returns:

an int, where the value was found, or -1

lastIndexOf

public int lastIndexOf(int val)

Find the lastIndexOf a given value

Parameters:

val - a int value to be found (from the back)

Returns:

an int , where the value was found, or -1