List interface to minimize the effort required to implement this interface backed by a "random access" data store (such as an array).
More...
#include <java_util_AbstractList.h>
Inheritance diagram for java::util::AbstractList:


Public Types | |
| enum | { xmogDefaultFlags = xmog_base::GLOBAL, xmogMajorVersion = 3, xmogMinorVersion = 2, xmogPatchVersion = 9, xmogBuildNumber = 2047 } |
|
typedef ::xmog_java_array_template< ::java::util::AbstractList > | array1D |
|
typedef ::xmog_java_array_template< ::xmog_java_array_template< ::java::util::AbstractList > > | array2D |
Public Member Functions | |
| AbstractList (::xmog_dummy _use_java_ctor,::xmog_localenv *p_xenv=NULL, xmog_flags f_xflags=xmogDefaultFlags) | |
| Sole constructor. | |
| virtual void | add (jint index, const ::java::lang::Object &element,::xmog_localenv *p_xenv=NULL, xmog_flags f_xflags=xmogDefaultFlags) |
| Inserts the specified element at the specified position in this list (optional operation). | |
| virtual bool | add (const ::java::lang::Object &o,::xmog_localenv *p_xenv=NULL, xmog_flags f_xflags=xmogDefaultFlags) |
| Appends the specified element to the end of this List (optional operation). | |
| virtual bool | addAll (jint index, const ::java::util::Collection &c,::xmog_localenv *p_xenv=NULL, xmog_flags f_xflags=xmogDefaultFlags) |
| Inserts all of the elements in the specified collection into this list at the specified position (optional operation). | |
| virtual bool | addAll (const ::java::util::Collection &c,::xmog_localenv *p_xenv=NULL, xmog_flags f_xflags=xmogDefaultFlags) |
The method representing the Java method java.util.Collection.addAll(). | |
| virtual void | clear (::xmog_localenv *p_xenv=NULL, xmog_flags f_xflags=xmogDefaultFlags) |
| Removes all of the elements from this collection (optional operation). | |
| virtual bool | contains (const ::java::lang::Object &o,::xmog_localenv *p_xenv=NULL, xmog_flags f_xflags=xmogDefaultFlags) |
The method representing the Java method java.util.Collection.contains(). | |
| virtual bool | containsAll (const ::java::util::Collection &c,::xmog_localenv *p_xenv=NULL, xmog_flags f_xflags=xmogDefaultFlags) |
The method representing the Java method java.util.Collection.containsAll(). | |
| virtual bool | equals (const ::java::lang::Object &o,::xmog_localenv *p_xenv=NULL, xmog_flags f_xflags=xmogDefaultFlags) |
| Compares the specified object with this list for equality. | |
| virtual ::java::lang::Object | get (jint index,::xmog_localenv *p_xenv=NULL, xmog_flags f_xflags=xmogDefaultFlags) |
| Returns the element at the specified position in this list. | |
| virtual jint | hashCode (::xmog_localenv *p_xenv=NULL, xmog_flags f_xflags=xmogDefaultFlags) |
| Returns the hash code value for this list. | |
| virtual jint | indexOf (const ::java::lang::Object &o,::xmog_localenv *p_xenv=NULL, xmog_flags f_xflags=xmogDefaultFlags) |
| Returns the index in this list of the first occurence of the specified element, or -1 if the list does not contain this element. | |
| virtual bool | isEmpty (::xmog_localenv *p_xenv=NULL, xmog_flags f_xflags=xmogDefaultFlags) |
The method representing the Java method java.util.Collection.isEmpty(). | |
| virtual ::java::util::Iterator | iterator (::xmog_localenv *p_xenv=NULL, xmog_flags f_xflags=xmogDefaultFlags) |
| Returns an iterator over the elements in this list in proper sequence. | |
| virtual jint | lastIndexOf (const ::java::lang::Object &o,::xmog_localenv *p_xenv=NULL, xmog_flags f_xflags=xmogDefaultFlags) |
| Returns the index in this list of the last occurence of the specified element, or -1 if the list does not contain this element. | |
| virtual bool | remove (const ::java::lang::Object &o,::xmog_localenv *p_xenv=NULL, xmog_flags f_xflags=xmogDefaultFlags) |
The method representing the Java method java.util.Collection.remove(). | |
| virtual ::java::lang::Object | remove (jint index,::xmog_localenv *p_xenv=NULL, xmog_flags f_xflags=xmogDefaultFlags) |
| Removes the element at the specified position in this list (optional operation). | |
| virtual bool | removeAll (const ::java::util::Collection &c,::xmog_localenv *p_xenv=NULL, xmog_flags f_xflags=xmogDefaultFlags) |
The method representing the Java method java.util.Collection.removeAll(). | |
| virtual bool | retainAll (const ::java::util::Collection &c,::xmog_localenv *p_xenv=NULL, xmog_flags f_xflags=xmogDefaultFlags) |
The method representing the Java method java.util.Collection.retainAll(). | |
| virtual ::java::lang::Object | set (jint index, const ::java::lang::Object &element,::xmog_localenv *p_xenv=NULL, xmog_flags f_xflags=xmogDefaultFlags) |
| Replaces the element at the specified position in this list with the specified element (optional operation). | |
| virtual jint | size (::xmog_localenv *p_xenv=NULL, xmog_flags f_xflags=xmogDefaultFlags) |
The method representing the Java method java.util.Collection.size(). | |
| virtual ::java::util::List | subList (jint fromIndex, jint toIndex,::xmog_localenv *p_xenv=NULL, xmog_flags f_xflags=xmogDefaultFlags) |
Returns a view of the portion of this list between fromIndex, inclusive, and toIndex, exclusive. | |
| virtual ::xmog_java_array_template< ::java::lang::Object > | toArray (const ::xmog_java_array_template< ::java::lang::Object > &a,::xmog_localenv *p_xenv=NULL, xmog_flags f_xflags=xmogDefaultFlags) |
The method representing the Java method java.util.Collection.toArray(). | |
| virtual ::xmog_java_array_template< ::java::lang::Object > | toArray (::xmog_localenv *p_xenv=NULL, xmog_flags f_xflags=xmogDefaultFlags) |
The method representing the Java method java.util.Collection.toArray(). | |
| virtual ::java::lang::String | toString (::xmog_localenv *p_xenv=NULL, xmog_flags f_xflags=xmogDefaultFlags) |
The method representing the Java method java.lang.Object.toString(). | |
List interface to minimize the effort required to implement this interface backed by a "random access" data store (such as an array).
For sequential access data (such as a linked list), AbstractSequentialList should be used in preference to this class.
To implement an unmodifiable list, the programmer needs only to extend this class and provide implementations for the get(int index) and size() methods.
To implement a modifiable list, the programmer must additionally override the set(int index, Object element) method (which otherwise throws an UnsupportedOperationException. If the list is variable-size the programmer must additionally override the add(int index, Object element) and remove(int index) methods.
The programmer should generally provide a void (no argument) and collection constructor, as per the recommendation in the Collection interface specification.
Unlike the other abstract collection implementations, the programmer does not have to provide an iterator implementation; the iterator and list iterator are implemented by this class, on top the "random access" methods: get(int index), set(int index, Object element), set(int index, Object element), add(int index, Object element) and remove(int index).
The documentation for each non-abstract methods in this class describes its implementation in detail. Each of these methods may be overridden if the collection being implemented admits a more efficient implementation.
This class is a member of the Java Collections Framework.
|
||||||||||||||||
|
Sole constructor. (For invocation by subclass constructors, typically implicit.)
|
|
||||||||||||||||||||
|
Inserts the specified element at the specified position in this list (optional operation). Shifts the element currently at that position (if any) and any subsequent elements to the right (adds one to their indices). This implementation always throws an UnsupportedOperationException.
Reimplemented from java::util::List. Reimplemented in java::util::ArrayList, and java::util::Vector. |
|
||||||||||||||||
|
Appends the specified element to the end of this List (optional operation).
This implementation calls
Note that this implementation throws an
Reimplemented from java::util::AbstractCollection. Reimplemented in java::util::ArrayList, and java::util::Vector. |
|
||||||||||||||||||||
|
Inserts all of the elements in the specified collection into this list at the specified position (optional operation). Shifts the element currently at that position (if any) and any subsequent elements to the right (increases their indices). The new elements will appear in the list in the order that they are returned by the specified collection's iterator. The behavior of this operation is unspecified if the specified collection is modified while the operation is in progress. (Note that this will occur if the specified collection is this list, and it's nonempty.)
This implementation gets an iterator over the specified collection and iterates over it, inserting the elements obtained from the iterator into this list at the appropriate position, one at a time, using
Note that this implementation throws an
Reimplemented from java::util::List. Reimplemented in java::util::ArrayList, and java::util::Vector. |
|
||||||||||||||||
|
The method representing the Java method
Reimplemented from java::util::AbstractCollection. Reimplemented in java::util::ArrayList, and java::util::Vector. |
|
||||||||||||
|
Removes all of the elements from this collection (optional operation). The collection will be empty after this call returns (unless it throws an exception).
This implementation calls
Note that this implementation throws an
Reimplemented from java::util::AbstractCollection. Reimplemented in java::util::ArrayList, and java::util::Vector. |
|
||||||||||||||||
|
The method representing the Java method
Reimplemented from java::util::AbstractCollection. Reimplemented in java::util::ArrayList, and java::util::Vector. |
|
||||||||||||||||
|
The method representing the Java method
Reimplemented from java::util::AbstractCollection. Reimplemented in java::util::Vector. |
|
||||||||||||||||
|
Compares the specified object with this list for equality.
Returns
This implementation first checks if the specified object is this list. If so, it returns
Reimplemented from java::util::List. Reimplemented in java::util::ArrayList, and java::util::Vector. |
|
||||||||||||||||
|
Returns the element at the specified position in this list.
Reimplemented from java::util::List. Reimplemented in java::util::ArrayList, and java::util::Vector. |
|
||||||||||||
|
Returns the hash code value for this list.
This implementation uses exactly the code that is used to define the list hash function in the documentation for the
Reimplemented from java::util::List. Reimplemented in java::util::ArrayList, and java::util::Vector. |
|
||||||||||||||||
|
Returns the index in this list of the first occurence of the specified element, or -1 if the list does not contain this element.
More formally, returns the lowest index
This implementation first gets a list iterator (with
Reimplemented from java::util::List. Reimplemented in java::util::ArrayList, and java::util::Vector. |
|
||||||||||||
|
The method representing the Java method
Reimplemented from java::util::AbstractCollection. Reimplemented in java::util::ArrayList, and java::util::Vector. |
|
||||||||||||
|
Returns an iterator over the elements in this list in proper sequence.
This implementation returns a straightforward implementation of the iterator interface, relying on the backing list's
Note that the iterator returned by this method will throw an
This implementation can be made to throw runtime exceptions in the face of concurrent modification, as described in the specification for the (protected)
Reimplemented from java::util::AbstractCollection. |
|
||||||||||||||||
|
Returns the index in this list of the last occurence of the specified element, or -1 if the list does not contain this element.
More formally, returns the highest index This implementation first gets a list iterator that points to the end of the list (with listIterator(size())). Then, it iterates backwards over the list until the specified element is found, or the beginning of the list is reached.
Reimplemented from java::util::List. Reimplemented in java::util::ArrayList, and java::util::Vector. |
|
||||||||||||||||
|
The method representing the Java method
Reimplemented from java::util::AbstractCollection. Reimplemented in java::util::Vector. |
|
||||||||||||||||
|
Removes the element at the specified position in this list (optional operation). Shifts any subsequent elements to the left (subtracts one from their indices). Returns the element that was removed from the list.
This implementation always throws an
Reimplemented from java::util::List. Reimplemented in java::util::ArrayList, and java::util::Vector. |
|
||||||||||||||||
|
The method representing the Java method
Reimplemented from java::util::AbstractCollection. Reimplemented in java::util::Vector. |
|
||||||||||||||||
|
The method representing the Java method
Reimplemented from java::util::AbstractCollection. Reimplemented in java::util::Vector. |
|
||||||||||||||||||||
|
Replaces the element at the specified position in this list with the specified element (optional operation).
This implementation always throws an
Reimplemented from java::util::List. Reimplemented in java::util::ArrayList, and java::util::Vector. |
|
||||||||||||
|
The method representing the Java method
Reimplemented from java::util::AbstractCollection. Reimplemented in java::util::ArrayList, and java::util::Vector. |
|
||||||||||||||||||||
|
Returns a view of the portion of this list between
(If This method eliminates the need for explicit range operations (of the sort that commonly exist for arrays). Any operation that expects a list can be used as a range operation by operating on a subList view instead of a whole list. For example, the following idiom removes a range of elements from a list:
list.subList(from, to).clear();
Similar idioms may be constructed for The semantics of the list returned by this method become undefined if the backing list (i.e., this list) is structurally modified in any way other than via the returned list. (Structural modifications are those that change the size of the list, or otherwise perturb it in such a fashion that iterations in progress may yield incorrect results.)
This implementation returns a list that subclasses
The subclass's
The
All methods first check to see if the actual
Reimplemented from java::util::List. Reimplemented in java::util::Vector. |
|
||||||||||||||||
|
The method representing the Java method
Reimplemented from java::util::AbstractCollection. Reimplemented in java::util::ArrayList, and java::util::Vector. |
|
||||||||||||
|
The method representing the Java method
Reimplemented from java::util::AbstractCollection. Reimplemented in java::util::ArrayList, and java::util::Vector. |
|
||||||||||||
|
The method representing the Java method
Reimplemented from java::util::AbstractCollection. Reimplemented in java::util::ArrayList, and java::util::Vector. |
1.4.1