| java.util.ArrayList
| ArrayList | | public class ArrayList extends AbstractList implements List<E>,Cloneable,Serializable,RandomAccess(Code) | | ArrayList is an implementation of List, backed by an array. All optional
operations are supported, adding, removing, and replacing. The elements can
be any objects.
since:
1.2 |
| Constructor Summary | |
| public | ArrayList()
Constructs a new instance of ArrayList with capacity for ten elements. | | public | ArrayList(int capacity)
Constructs a new instance of ArrayList with the specified capacity. | | public | ArrayList(Collection<? extends E> collection)
Constructs a new instance of ArrayList containing the elements in the
specified collection. |
| Method Summary | |
| public void | add(int location, E object)
Inserts the specified object into this ArrayList at the specified
location. | | public boolean | add(E object)
Adds the specified object at the end of this ArrayList. | | public boolean | addAll(int location, Collection<? extends E> collection)
Inserts the objects in the specified Collection at the specified location
in this ArrayList. | | public boolean | addAll(Collection<? extends E> collection)
Adds the objects in the specified Collection to this ArrayList. | | public void | clear()
Removes all elements from this ArrayList, leaving it empty. | | public Object | clone()
Answers a new ArrayList with the same elements, size and capacity as this
ArrayList. | | public boolean | contains(Object object)
Searches this ArrayList for the specified object. | | public void | ensureCapacity(int minimumCapacity)
Ensures that this ArrayList can hold the specified number of elements
without growing. | | public E | get(int location)
Answers the element at the specified location in this ArrayList. | | public int | indexOf(Object object)
Searches this ArrayList for the specified object and returns the index of
the first occurrence. | | public boolean | isEmpty()
Answers if this ArrayList has no elements, a size of zero. | | public int | lastIndexOf(Object object)
Searches this ArrayList for the specified object and returns the index of
the last occurrence. | | public E | remove(int location)
Removes the object at the specified location from this ArrayList. | | public boolean | remove(Object object)
Removes the first one of the specified object in this list, if present. | | protected void | removeRange(int start, int end)
Removes the objects in the specified range from the start to the end, but
not including the end index. | | public E | set(int location, E object)
Replaces the element at the specified location in this ArrayList with the
specified object. | | public int | size()
Answers the number of elements in this ArrayList. | | public Object[] | toArray()
Answers a new array containing all elements contained in this ArrayList. | | public T[] | toArray(T[] contents)
Answers an array containing all elements contained in this ArrayList. | | public void | trimToSize()
Sets the capacity of this ArrayList to be the same as the size. |
| ArrayList | | public ArrayList()(Code) | | Constructs a new instance of ArrayList with capacity for ten elements.
|
| ArrayList | | public ArrayList(int capacity)(Code) | | Constructs a new instance of ArrayList with the specified capacity.
Parameters:
capacity - the initial capacity of this ArrayList |
| ArrayList | | public ArrayList(Collection<? extends E> collection)(Code) | | Constructs a new instance of ArrayList containing the elements in the
specified collection. The ArrayList will have an initial capacity which
is 110% of the size of the collection. The order of the elements in this
ArrayList is the order they are returned by the collection iterator.
Parameters:
collection - the collection of elements to add |
| add | | public void add(int location, E object)(Code) | | Inserts the specified object into this ArrayList 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
ArrayList, the object is added at the end.
Parameters:
location - the index at which to insert
Parameters:
object - the object to add
exception:
IndexOutOfBoundsException - when location < 0 || >= size() |
| add | | public boolean add(E object)(Code) | | Adds the specified object at the end of this ArrayList.
Parameters:
object - the object to add true |
| addAll | | public boolean addAll(int location, Collection<? extends E> collection)(Code) | | Inserts the objects in the specified Collection at the specified location
in this ArrayList. 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 ArrayList is modified, false otherwise
exception:
IndexOutOfBoundsException - when location < 0 || > size() |
| addAll | | public boolean addAll(Collection<? extends E> collection)(Code) | | Adds the objects in the specified Collection to this ArrayList.
Parameters:
collection - the Collection of objects true if this ArrayList is modified, false otherwise |
| clone | | public Object clone()(Code) | | Answers a new ArrayList with the same elements, size and capacity as this
ArrayList.
a shallow copy of this ArrayList
See Also: java.lang.Cloneable |
| contains | | public boolean contains(Object object)(Code) | | Searches this ArrayList for the specified object.
Parameters:
object - the object to search for true if object is an element of this ArrayList,false otherwise |
| ensureCapacity | | public void ensureCapacity(int minimumCapacity)(Code) | | Ensures that this ArrayList can hold the specified number of elements
without growing.
Parameters:
minimumCapacity - the minimum number of elements that this ArrayList will holdbefore growing |
| get | | public E get(int location)(Code) | | Answers the element at the specified location in this ArrayList.
Parameters:
location - the index of the element to return the element at the specified index
exception:
IndexOutOfBoundsException - when location < 0 || >= size() |
| indexOf | | public int indexOf(Object object)(Code) | | Searches this ArrayList 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 |
| isEmpty | | public boolean isEmpty()(Code) | | Answers if this ArrayList has no elements, a size of zero.
true if this ArrayList has no elements, false otherwise
See Also: ArrayList.size |
| lastIndexOf | | public int lastIndexOf(Object object)(Code) | | Searches this ArrayList 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 |
| remove | | public E remove(int location)(Code) | | Removes the object at the specified location from this ArrayList.
Parameters:
location - the index of the object to remove the removed object
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 end, but
not including the 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:
IndexOutOfBoundsException - when start < 0, start > end orend > size() |
| set | | public E set(int location, E object)(Code) | | Replaces the element at the specified location in this ArrayList 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:
IndexOutOfBoundsException - when location < 0 || >= size() |
| size | | public int size()(Code) | | Answers the number of elements in this ArrayList.
the number of elements in this ArrayList |
| toArray | | public Object[] toArray()(Code) | | Answers a new array containing all elements contained in this ArrayList.
an array of the elements from this ArrayList |
| toArray | | public T[] toArray(T[] contents)(Code) | | Answers an array containing all elements contained in this ArrayList. If
the specified array is large enough to hold the elements, the specified
array is used, otherwise an array of the same type is created. If the
specified array is used and is larger than this ArrayList, the array
element following the collection elements is set to null.
Parameters:
contents - the array an array of the elements from this ArrayList
exception:
ArrayStoreException - when the type of an element in this ArrayList cannot bestored in the type of the specified array |
| trimToSize | | public void trimToSize()(Code) | | Sets the capacity of this ArrayList to be the same as the size.
See Also: ArrayList.size |
|
|