org.exolab.castor.util
Class List
java.lang.Object
org.exolab.castor.util.List
- Cloneable, java.io.Serializable
public class List
extends java.lang.Object
implements Cloneable, java.io.Serializable
This is my implementation of the JDK 1.2 List interface.
I wrote this because I want people using 1.1.x to be able
to use my apps, but I don't want to use a "synchronized" Vector.
I also wanted to get a start in moving my source to JDK 1.2
I use the implementation of the hashCode method that is listed
in the JDK 1.2 API, so this List can be compared correctly to actual
JDK 1.2 lists using the equals method.
Note: This is not a complete implementation yet,
None of the methods that take a Collection have been imlplemented.
$Revision: 1.1.1.1 $ $Date: 2003/03/03 07:09:05 $List() - Creates a new BasicSet with the default Size
|
List(int size)
|
boolean | add(Object obj) - Adds the specified Object to the list
|
boolean | add(int index, Object obj) - Adds the specified Object to the list at the specified index
|
void | clear() - Removes all elements from the list
|
Object | clone()
|
boolean | contains(Object obj) - Returns true if the specified element is contained in the list.
|
boolean | equals(Object obj) - Compares the specified object with this list for equality.
|
Object | get(int index) - Returns the element at the specified position in this list.
|
int | hashCode() - As defined by the JDK 1.2 API spec:
Returns the hash code value for this list.
|
int | indexOf(Object obj) - Returns the index of the first occurrence of the specified element,
or -1 if the element is not contained in the List
|
boolean | isEmpty() - Returns true if there are no elements in the List.
|
int | lastIndexOf(Object obj) - Returns the index of the last occurrence of the specified element,
or -1 if the element is not contained in the List
|
boolean | remove(Object obj) - Removes the first occurrence of the specified element from the List
|
Object | remove(int index) - Removes the element at the specified index from the List
|
Object | set(int index, Object element) - Replaces the element at the specified position in this list
with the specified element.
|
int | size() - Returns the number of elements in the List
|
List | subList(int fromIndex, int toIndex) - Returns a new List which contains elements from a given section
of this list.
|
Object[] | toArray() - Returns an array containing all of the elements in this list
in proper sequence.
|
Object[] | toArray(Object[] dst) - Returns an array containing all of the elements in this list
in proper sequence.
|
Object[] | toArray(Object[] dst, int offset) - Returns an array containing all of the elements in this list
in proper sequence.
|
void | trimToSize() - Reduces the capacity of the internal buffer to the current size
freeing up unused memory.
|
List
public List()
Creates a new BasicSet with the default Size
List
public List(int size)
add
public boolean add(Object obj)
Adds the specified Object to the list
obj
- the Object to add to the list
- true if the Object is added to the list
add
public boolean add(int index,
Object obj)
throws IndexOutOfBoundsException
Adds the specified Object to the list at the specified index
obj
- the Object to add to the list
- true if the Object is added to the list
clear
public void clear()
Removes all elements from the list
clone
public Object clone()
contains
public boolean contains(Object obj)
Returns true if the specified element is contained in the list.
if the specfied element is null, then if the list contains a null
value, true will be returned.
obj
- the element to search the list for
- true if specified element is contained in the list
equals
public boolean equals(Object obj)
Compares the specified object with this list for equality.
Returns true if and only if the specified Object is a list
and all of its associated elements are equal to the elements
of this list
get
public Object get(int index)
throws IndexOutOfBoundsException
Returns the element at the specified position in this list.
index
- the position of the element to return
hashCode
public int hashCode()
As defined by the JDK 1.2 API spec:
Returns the hash code value for this list.
The hash code of a list is defined to be the result of the following
calculation:
hashCode = 1;
Iterator i = list.iterator();
while (i.hasNext()) {
Object obj = i.next();
hashCode = 31*hashCode + (obj==null ? 0 : obj.hashCode());
}
- the hash code value for this list
indexOf
public int indexOf(Object obj)
Returns the index of the first occurrence of the specified element,
or -1 if the element is not contained in the List
obj
- the Object to get the index for
isEmpty
public boolean isEmpty()
Returns true if there are no elements in the List.
- true if there are no elements in the List.
lastIndexOf
public int lastIndexOf(Object obj)
Returns the index of the last occurrence of the specified element,
or -1 if the element is not contained in the List
obj
- the Object to get the last index for
remove
public boolean remove(Object obj)
Removes the first occurrence of the specified element from the List
obj
- the Object to remove from the List
- true if the Object was removed from the list
remove
public Object remove(int index)
Removes the element at the specified index from the List
index
- the position in the list tp remove the element from
- the Object that was removed from the list
set
public Object set(int index,
Object element)
throws IndexOutOfBoundsException
Replaces the element at the specified position in this list
with the specified element.
index
- the position in the list to place the element atelement
- the element to add to the list
size
public int size()
Returns the number of elements in the List
- the number of elements in the List
subList
public List subList(int fromIndex,
int toIndex)
Returns a new List which contains elements from a given section
of this list.
fromIndex
- the start index (inclusize) of elements
to add to the new listtoIndex
- the end index (exclusive)of the elements to add
to the new list
- a new List which contains elements from a given section
of this list.
toArray
public Object[] toArray()
Returns an array containing all of the elements in this list
in proper sequence.
- the array of elements of this List
toArray
public Object[] toArray(Object[] dst)
Returns an array containing all of the elements in this list
in proper sequence.
- the array of elements of this List
toArray
public Object[] toArray(Object[] dst,
int offset)
Returns an array containing all of the elements in this list
in proper sequence.
- the array of elements of this List
trimToSize
public void trimToSize()
Reduces the capacity of the internal buffer to the current size
freeing up unused memory.
Intalio Inc. (C) 1999-2003. All rights reserved http://www.intalio.com