public class ArrayUnsignedByteList extends RandomAccessShortList implements ShortList, java.io.Serializable
ShortList
backed by an array of unsigned
byte
values.
This list stores short
values
in the range [MIN_VALUE
,
MAX_VALUE
] in 8-bits
per element. Attempts to use elements outside this
range may cause an
IllegalArgumentException
to be thrown.
This implementation supports all optional methods.RandomAccessShortList.RandomAccessShortListIterator, RandomAccessShortList.RandomAccessShortSubList
Modifier and Type | Field and Description |
---|---|
private byte[] |
_data |
private int |
_size |
static short |
MAX_VALUE
The maximum possible unsigned 8-bit value.
|
static short |
MIN_VALUE
The minimum possible unsigned 8-bit value.
|
Constructor and Description |
---|
ArrayUnsignedByteList()
Construct an empty list with the default
initial capacity.
|
ArrayUnsignedByteList(int initialCapacity)
Construct an empty list with the given
initial capacity.
|
ArrayUnsignedByteList(ShortCollection 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,
short element)
Inserts the specified element at the specified position
(optional operation).
|
private void |
assertValidUnsignedByte(short 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 byte |
fromShort(short value) |
short |
get(int index)
Returns the element at the specified position within
me.
|
private void |
readObject(java.io.ObjectInputStream in) |
short |
removeElementAt(int index)
Removes the element at the specified position in
(optional operation).
|
short |
set(int index,
short 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 short |
toShort(byte 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
private transient byte[] _data
private int _size
public static final short MAX_VALUE
public static final short MIN_VALUE
public ArrayUnsignedByteList()
public ArrayUnsignedByteList(int initialCapacity)
java.lang.IllegalArgumentException
- when initialCapacity is negativepublic ArrayUnsignedByteList(ShortCollection that)
that
- the non-null
collection of int
s
to addjava.lang.NullPointerException
- if that is null
ShortCollection.addAll(org.apache.commons.collections.primitives.ShortCollection)
public short get(int index)
MIN_VALUE
and MAX_VALUE
, inclusive.get
in interface ShortList
get
in class RandomAccessShortList
index
- the index of the element to returnjava.lang.IndexOutOfBoundsException
- if the specified index is out of rangepublic int size()
ShortCollection
size
in interface ShortCollection
size
in class RandomAccessShortList
public short removeElementAt(int index)
MIN_VALUE
and MAX_VALUE
, inclusive.removeElementAt
in interface ShortList
removeElementAt
in class RandomAccessShortList
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 short set(int index, short element)
IllegalArgumentException
if element
is less than MIN_VALUE
or greater than MAX_VALUE
.set
in interface ShortList
set
in class RandomAccessShortList
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, short element)
IllegalArgumentException
if element
is less than MIN_VALUE
or greater than MAX_VALUE
.add
in interface ShortList
add
in class RandomAccessShortList
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 short toShort(byte value)
private final byte fromShort(short value)
private final void assertValidUnsignedByte(short 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