| java.util.AbstractList
| AbstractList | | abstract public class AbstractList extends AbstractCollection implements List<E>(Code) | | AbstractList is an abstract implementation of the List interface, optimized
for a backing store which supports random access. This implementation does
not support adding or replacing. A subclass must implement the abstract
methods get() and size().
since:
1.2 |
| Field Summary | |
| protected transient int | modCount
|
| Constructor Summary | |
| protected | AbstractList()
Constructs a new instance of this AbstractList. |
| Method Summary | |
| public void | add(int location, E object)
Inserts the specified object into this List at the specified location.
The object is inserted before any previous element at the specified
location. | | public boolean | add(E object)
Adds the specified object at the end of this List. | | public boolean | addAll(int location, Collection<? extends E> collection)
Inserts the objects in the specified Collection at the specified location
in this List. | | public void | clear()
Removes all elements from this List, leaving it empty. | | public boolean | equals(Object object)
Compares the specified object to this List and answer if they are equal. | | abstract public E | get(int location)
Answers the element at the specified location in this List. | | public int | hashCode()
Answers an integer hash code for the receiver. | | public int | indexOf(Object object)
Searches this List for the specified object and returns the index of the
first occurrence. | | public Iterator<E> | iterator()
Answers an Iterator on the elements of this List. | | public int | lastIndexOf(Object object)
Searches this List for the specified object and returns the index of the
last occurrence. | | public ListIterator<E> | listIterator()
Answers a ListIterator on the elements of this List. | | public ListIterator<E> | listIterator(int location)
Answers a ListIterator on the elements of this List. | | public E | remove(int location)
Removes the object at the specified location from this List. | | protected void | removeRange(int start, int end)
Removes the objects in the specified range from the start to the, but not
including, end index. | | public E | set(int location, E object)
Replaces the element at the specified location in this List with the
specified object. | | public List<E> | subList(int start, int end)
Returns a part of consecutive elements of this list as a view. |
| modCount | | protected transient int modCount(Code) | | |
| AbstractList | | protected AbstractList()(Code) | | Constructs a new instance of this AbstractList.
|
| add | | public void add(int location, E object)(Code) | | Inserts the specified object into this List at the specified location.
The object is inserted before any previous element at the specified
location. If the location is equal to the size of this List, the object
is added at the end.
Parameters:
location - the index at which to insert
Parameters:
object - the object to add
exception:
UnsupportedOperationException - when adding to this List is not supported
exception:
ClassCastException - when the class of the object is inappropriate for thisList
exception:
IllegalArgumentException - when the object cannot be added to this List
exception:
IndexOutOfBoundsException - when location < 0 || >= size() |
| add | | public boolean add(E object)(Code) | | Adds the specified object at the end of this List.
Parameters:
object - the object to add true
exception:
UnsupportedOperationException - when adding to this List is not supported
exception:
ClassCastException - when the class of the object is inappropriate for thisList
exception:
IllegalArgumentException - when the object cannot be added to this List |
| addAll | | public boolean addAll(int location, Collection<? extends E> collection)(Code) | | Inserts the objects in the specified Collection at the specified location
in this List. The objects are added in the order they are returned from
the Collection iterator.
Parameters:
location - the index at which to insert
Parameters:
collection - the Collection of objects true if this List is modified, false otherwise
exception:
UnsupportedOperationException - when adding to this List is not supported
exception:
ClassCastException - when the class of an object is inappropriate for this List
exception:
IllegalArgumentException - when an object cannot be added to this List
exception:
IndexOutOfBoundsException - when location < 0 || >= size() |
| equals | | public boolean equals(Object object)(Code) | | Compares the specified object to this List and answer if they are equal.
The object must be a List which contains the same objects in the same
order.
Parameters:
object - the object to compare with this object true if the specified object is equal to this List, falseotherwise
See Also: AbstractList.hashCode |
| get | | abstract public E get(int location)(Code) | | Answers the element at the specified location in this List.
Parameters:
location - the index of the element to return the element at the specified index
exception:
IndexOutOfBoundsException - when location < 0 || >= size() |
| hashCode | | public int hashCode()(Code) | | Answers an integer hash code for the receiver. Objects which are equal
answer the same value for this method.
the receiver's hash
See Also: AbstractList.equals |
| indexOf | | public int indexOf(Object object)(Code) | | Searches this List for the specified object and returns the index of the
first occurrence.
Parameters:
object - the object to search for the index of the first occurrence of the object |
| iterator | | public Iterator<E> iterator()(Code) | | Answers an Iterator on the elements of this List. The elements are
iterated in the same order that they occur in the List.
an Iterator on the elements of this List
See Also: Iterator |
| lastIndexOf | | public int lastIndexOf(Object object)(Code) | | Searches this List for the specified object and returns the index of the
last occurrence.
Parameters:
object - the object to search for the index of the last occurrence of the object |
| listIterator | | public ListIterator<E> listIterator()(Code) | | Answers a ListIterator on the elements of this List. The elements are
iterated in the same order that they occur in the List.
a ListIterator on the elements of this List
See Also: ListIterator |
| listIterator | | public ListIterator<E> listIterator(int location)(Code) | | Answers a ListIterator on the elements of this List. The elements are
iterated in the same order that they occur in the List. The iteration
starts at the specified location.
Parameters:
location - the index at which to start the iteration a ListIterator on the elements of this List
exception:
IndexOutOfBoundsException - when location < 0 || >= size()
See Also: ListIterator |
| remove | | public E remove(int location)(Code) | | Removes the object at the specified location from this List.
Parameters:
location - the index of the object to remove the removed object
exception:
UnsupportedOperationException - when removing from this List is not supported
exception:
IndexOutOfBoundsException - when location < 0 || >= size() |
| removeRange | | protected void removeRange(int start, int end)(Code) | | Removes the objects in the specified range from the start to the, but not
including, end index.
Parameters:
start - the index at which to start removing
Parameters:
end - the index one past the end of the range to remove
exception:
UnsupportedOperationException - when removing from this List is not supported
exception:
IndexOutOfBoundsException - when start < 0 |
| set | | public E set(int location, E object)(Code) | | Replaces the element at the specified location in this List with the
specified object.
Parameters:
location - the index at which to put the specified object
Parameters:
object - the object to add the previous element at the index
exception:
UnsupportedOperationException - when replacing elements in this List is not supported
exception:
ClassCastException - when the class of an object is inappropriate for this List
exception:
IllegalArgumentException - when an object cannot be added to this List
exception:
IndexOutOfBoundsException - when location < 0 || >= size() |
| subList | | public List<E> subList(int start, int end)(Code) | | Returns a part of consecutive elements of this list as a view. From start
(inclusive), to end(exclusive). The returned view will be of zero length
if start equals end. Any change occurs in the returned subList will be
reflected to the original list, and vice-versa. All the supported
optional operations by the original list will also be supported by this
subList.
This method can be used as a handy method to do some operations on a sub
range of the original list. For example: list.subList(from, to).clear();
If the original list is modified other than through the returned subList,
the behavior of the returned subList becomes undefined.
The returned subList is a subclass of AbstractList. The subclass stores
offset, size of itself, and modCount of the original list. If the
original list implements RandomAccess interface, the returned subList
also implements RandomAccess interface.
The subList's set(int, Object), get(int), add(int, Object), remove(int),
addAll(int, Collection) and removeRange(int, int) methods first check the
bounds, adjust offsets and then call the corresponding methods of the
original AbstractList. addAll(Collection c) method of the returned
subList calls the original addAll(offset + size, c).
The listIterator(int) method of the subList wraps the original list
iterator. The iterator() method of the subList invokes the original
listIterator() method, and the size() method merely returns the size of
the subList.
All methods will throw a ConcurrentModificationException if the modCount
of the original list is not equal to the expected value.
Parameters:
start - start index of the subList, include start
Parameters:
end - end index of the subList, exclude end a subList view of this list start from start (inclusive), endwith end (exclusive)
exception:
IndexOutOfBoundsException - when (start < 0 || end > size())
exception:
IllegalArgumentException - when (start > end) |
|
|