org.apache.commons.collections.primitives
public class ArrayUnsignedIntList extends RandomAccessLongList implements LongList, java.io.Serializable
IntList
backed by an array of unsigned
int
values.
This list stores int
values
in the range [0
,
65535
] in 16-bits
per element. Attempts to use elements outside this
range may cause an
IllegalArgumentException
to be thrown.
This implementation supports all optional methods.RandomAccessLongList.RandomAccessLongListIterator, RandomAccessLongList.RandomAccessLongSubList
Modifier and Type | Field and Description |
---|---|
private int[] |
_data |
private int |
_size |
static long |
MAX_VALUE
The maximum possible unsigned 32-bit value.
|
static long |
MIN_VALUE
The minimum possible unsigned 32-bit value.
|
Constructor and Description |
---|
ArrayUnsignedIntList()
Construct an empty list with the default
initial capacity.
|
ArrayUnsignedIntList(int initialCapacity)
Construct an empty list with the given
initial capacity.
|
ArrayUnsignedIntList(LongCollection that)
Constructs a list containing the elements of the given collection,
in the order they are returned by that collection's iterator.
|
Modifier and Type | Method and Description |
---|---|
void |
add(int index,
long element)
Inserts the specified element at the specified position
(optional operation).
|
private void |
assertValidUnsignedInt(long value) |
private void |
checkRange(int index) |
private void |
checkRangeIncludingEndpoint(int index) |
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.
|
private int |
fromLong(long value) |
long |
get(int index)
Returns the element at the specified position within
me.
|
private void |
readObject(java.io.ObjectInputStream in) |
long |
removeElementAt(int index)
Removes the element at the specified position in
(optional operation).
|
long |
set(int index,
long element)
Replaces the element at the specified
position in me with the specified element
(optional operation).
|
int |
size()
Returns the number of elements I contain.
|
private long |
toLong(int value) |
void |
trimToSize()
Reduce my capacity, if necessary, to match my
current
size . |
private void |
writeObject(java.io.ObjectOutputStream out) |
add, addAll, equals, getModCount, hashCode, incrModCount, indexOf, iterator, lastIndexOf, listIterator, listIterator, subList, toString
addAll, clear, contains, containsAll, isEmpty, removeAll, removeElement, retainAll, toArray, toArray
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
add, addAll, equals, hashCode, indexOf, iterator, lastIndexOf, listIterator, listIterator, subList
addAll, clear, contains, containsAll, isEmpty, removeAll, removeElement, retainAll, toArray, toArray
public static final long MAX_VALUE
public static final long MIN_VALUE
private transient int[] _data
private int _size
public ArrayUnsignedIntList()
public ArrayUnsignedIntList(int initialCapacity)
java.lang.IllegalArgumentException
- when initialCapacity is negativepublic ArrayUnsignedIntList(LongCollection that)
that
- the non-null
collection of int
s
to addjava.lang.NullPointerException
- if that is null
AbstractLongCollection.addAll(LongCollection)
public long get(int index)
MIN_VALUE
and MAX_VALUE
, inclusive.get
in interface LongList
get
in class RandomAccessLongList
index
- the index of the element to returnjava.lang.IndexOutOfBoundsException
- if the specified index is out of rangepublic int size()
LongCollection
size
in interface LongCollection
size
in class RandomAccessLongList
public long removeElementAt(int index)
MIN_VALUE
and MAX_VALUE
, inclusive.removeElementAt
in interface LongList
removeElementAt
in class RandomAccessLongList
index
- the index of the element to removejava.lang.UnsupportedOperationException
- when this operation is not
supportedjava.lang.IndexOutOfBoundsException
- if the specified index is out of rangepublic long set(int index, long element)
IllegalArgumentException
if element
is less than MIN_VALUE
or greater than MAX_VALUE
.set
in interface LongList
set
in class RandomAccessLongList
index
- the index of the element to changeelement
- the value to be stored at the specified positionjava.lang.UnsupportedOperationException
- when this operation is not
supportedjava.lang.IndexOutOfBoundsException
- if the specified index is out of rangepublic void add(int index, long element)
IllegalArgumentException
if element
is less than MIN_VALUE
or greater than MAX_VALUE
.add
in interface LongList
add
in class RandomAccessLongList
index
- the index at which to insert the elementelement
- the value to insertjava.lang.UnsupportedOperationException
- when this operation is not
supportedjava.lang.IllegalArgumentException
- if some aspect of the specified element
prevents it from being added to mejava.lang.IndexOutOfBoundsException
- if the specified index is out of rangepublic void ensureCapacity(int mincap)
public void trimToSize()
size
.private final long toLong(int value)
private final int fromLong(long value)
private final void assertValidUnsignedInt(long value) throws java.lang.IllegalArgumentException
java.lang.IllegalArgumentException
private void writeObject(java.io.ObjectOutputStream out) throws java.io.IOException
java.io.IOException
private void readObject(java.io.ObjectInputStream in) throws java.io.IOException, java.lang.ClassNotFoundException
java.io.IOException
java.lang.ClassNotFoundException
private final void checkRange(int index)
private final void checkRangeIncludingEndpoint(int index)
Copyright (c) 2002-2003 - Apache Software Foundation