org.apache.commons.collections.primitives

Class ArrayLongList

public class ArrayLongList extends RandomAccessLongList implements LongList, Serializable

An LongList backed by an array of longs. This implementation supports all optional methods.

Since: Commons Primitives 1.0

Version: $Revision: 1.3 $ $Date: 2003/10/16 20:49:36 $

Author: Rodney Waldhoff

Field Summary
long[]_data
int_size
Constructor Summary
ArrayLongList()
Construct an empty list with the default initial capacity.
ArrayLongList(int initialCapacity)
Construct an empty list with the given initial capacity.
ArrayLongList(LongCollection that)
Constructs a list containing the elements of the given collection, in the order they are returned by that collection's iterator.
Method Summary
voidadd(int index, long element)
Inserts the specified element at the specified position (optional operation).
voidcheckRange(int index)
voidcheckRangeIncludingEndpoint(int index)
voidensureCapacity(int mincap)
Increases my capacity, if necessary, to ensure that I can hold at least the number of elements specified by the minimum capacity argument without growing.
longget(int index)
voidreadObject(ObjectInputStream in)
longremoveElementAt(int index)
Removes the element at the specified position in (optional operation).
longset(int index, long element)
Replaces the element at the specified position in me with the specified element (optional operation).
intsize()
voidtrimToSize()
Reduce my capacity, if necessary, to match my current size.
voidwriteObject(ObjectOutputStream out)

Field Detail

_data

private transient long[] _data

_size

private int _size

Constructor Detail

ArrayLongList

public ArrayLongList()
Construct an empty list with the default initial capacity.

ArrayLongList

public ArrayLongList(int initialCapacity)
Construct an empty list with the given initial capacity.

Throws: IllegalArgumentException when initialCapacity is negative

ArrayLongList

public ArrayLongList(LongCollection that)
Constructs a list containing the elements of the given collection, in the order they are returned by that collection's iterator.

Parameters: that the non-null collection of longs to add

Throws: NullPointerException if that is null

See Also: ArrayLongList

Method Detail

add

public void add(int index, long element)
Inserts the specified element at the specified position (optional operation). Shifts the element currently at that position (if any) and any subsequent elements to the right, increasing their indices.

Parameters: index the index at which to insert the element element the value to insert

Throws: UnsupportedOperationException when this operation is not supported IllegalArgumentException if some aspect of the specified element prevents it from being added to me IndexOutOfBoundsException if the specified index is out of range

checkRange

private final void checkRange(int index)

checkRangeIncludingEndpoint

private final void checkRangeIncludingEndpoint(int index)

ensureCapacity

public void ensureCapacity(int mincap)
Increases my capacity, if necessary, to ensure that I can hold at least the number of elements specified by the minimum capacity argument without growing.

get

public long get(int index)

readObject

private void readObject(ObjectInputStream in)

removeElementAt

public long removeElementAt(int index)
Removes the element at the specified position in (optional operation). Any subsequent elements are shifted to the left, subtracting one from their indices. Returns the element that was removed.

Parameters: index the index of the element to remove

Returns: the value of the element that was removed

Throws: UnsupportedOperationException when this operation is not supported IndexOutOfBoundsException if the specified index is out of range

set

public long set(int index, long element)
Replaces the element at the specified position in me with the specified element (optional operation).

Parameters: index the index of the element to change element the value to be stored at the specified position

Returns: the value previously stored at the specified position

Throws: UnsupportedOperationException when this operation is not supported IndexOutOfBoundsException if the specified index is out of range

size

public int size()

trimToSize

public void trimToSize()
Reduce my capacity, if necessary, to match my current size.

writeObject

private void writeObject(ObjectOutputStream out)
Copyright (c) 2002-2003 - Apache Software Foundation