|
Oracle® Coherence Java API Reference Release 3.7.1.0 E22843-01 |
|||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object
com.tangosol.util.SubList
public class SubList
Implements a list which is based on another list, represents a sub-list of the underlying list.
Constructor Summary | |
---|---|
SubList(java.util.List list, int nStart, int nCount) Construct a SubList from provided list. |
Method Summary | |
---|---|
void |
add(int index, java.lang.Object element) Inserts the specified element at the specified position in this list (optional operation). |
boolean |
add(java.lang.Object o) Appends the specified element to the end of this list (optional operation). |
boolean |
addAll(java.util.Collection c) Appends all of the elements in the specified collection to the end of this list, in the order that they are returned by the specified collection's iterator (optional operation). |
boolean |
addAll(int index, java.util.Collection c) Inserts all of the elements in the specified collection into this list at the specified position (optional operation). |
void |
clear() Removes all of the elements from this list (optional operation). |
boolean |
contains(java.lang.Object o) Returns true if this list contains the specified element. |
boolean |
containsAll(java.util.Collection c) Returns true if this list contains all of the elements of the specified collection. |
boolean |
equals(java.lang.Object o) Compares the specified object with this list for equality. |
java.lang.Object |
get(int index) Returns the element at the specified position in this list. |
int |
hashCode() Returns the hash code value for this list. |
int |
indexOf(java.lang.Object o) Returns the index in this list of the first occurrence of the specified element, or -1 if this list does not contain this element. |
boolean |
isEmpty() Returns true if this list contains no elements. |
java.util.Iterator |
iterator() Returns an iterator over the elements in this list in proper sequence. |
int |
lastIndexOf(java.lang.Object o) Returns the index in this list of the last occurrence of the specified element, or -1 if this list does not contain this element. |
java.util.ListIterator |
listIterator() Returns a list iterator of the elements in this list (in proper sequence). |
java.util.ListIterator |
listIterator(int index) Returns a list iterator of the elements in this list (in proper sequence), starting at the specified position in this list. |
java.lang.Object |
remove(int index) Removes the element at the specified position in this list (optional operation). |
boolean |
remove(java.lang.Object o) Removes the first occurrence in this list of the specified element (optional operation). |
boolean |
removeAll(java.util.Collection c) Removes from this list all the elements that are contained in the specified collection (optional operation). |
boolean |
retainAll(java.util.Collection c) Retains only the elements in this list that are contained in the specified collection (optional operation). |
java.lang.Object |
set(int index, java.lang.Object element) Replaces the element at the specified position in this list with the specified element (optional operation). |
int |
size() Returns the number of elements in this list. |
java.util.List |
subList(int fromIndex, int toIndex) Returns a view of the portion of this list between the specified fromIndex, inclusive, and toIndex, exclusive. |
java.lang.Object[] |
toArray() Returns an array containing all of the elements in this list in proper sequence. |
java.lang.Object[] |
toArray(java.lang.Object[] a) Returns an array containing all of the elements in this list in proper sequence; the runtime type of the returned array is that of the specified array. |
Constructor Detail |
---|
public SubList(java.util.List list, int nStart, int nCount)
list
- underlying listnStart
- the index of first list element to include in sub-listnCount
- the max size of created sub-listMethod Detail |
---|
public int size()
size
in interface java.util.Collection
size
in interface java.util.List
public boolean isEmpty()
isEmpty
in interface java.util.Collection
isEmpty
in interface java.util.List
public boolean contains(java.lang.Object o)
contains
in interface java.util.Collection
contains
in interface java.util.List
o
- element whose presence in this list is to be tested.public java.util.Iterator iterator()
iterator
in interface java.lang.Iterable
iterator
in interface java.util.Collection
iterator
in interface java.util.List
public java.lang.Object[] toArray()
toArray
in interface java.util.Collection
toArray
in interface java.util.List
Arrays.asList(Object[])
public java.lang.Object[] toArray(java.lang.Object[] a)
toArray
in interface java.util.Collection
toArray
in interface java.util.List
a
- the array into which the elements of this list are to be stored, if it is big enough; otherwise, a new array of the same runtime type is allocated for this purpose.public boolean add(java.lang.Object o)
Lists that support this operation may place limitations on what elements may be added to this list. In particular, some lists will refuse to add null elements, and others will impose restrictions on the type of elements that may be added. List classes should clearly specify in their documentation any restrictions on what elements may be added.
add
in interface java.util.Collection
add
in interface java.util.List
o
- element to be appended to this list.public boolean remove(java.lang.Object o)
remove
in interface java.util.Collection
remove
in interface java.util.List
o
- element to be removed from this list, if present.public boolean containsAll(java.util.Collection c)
containsAll
in interface java.util.Collection
containsAll
in interface java.util.List
c
- collection to be checked for containment in this list.List.contains(Object)
public boolean addAll(java.util.Collection c)
addAll
in interface java.util.Collection
addAll
in interface java.util.List
c
- collection whose elements are to be added to this list.List.add(Object)
public boolean addAll(int index, java.util.Collection c)
addAll
in interface java.util.List
index
- index at which to insert first element from the specified collection.c
- elements to be inserted into this list.public boolean removeAll(java.util.Collection c)
removeAll
in interface java.util.Collection
removeAll
in interface java.util.List
c
- collection that defines which elements will be removed from this list.List.remove(Object)
, List.contains(Object)
public boolean retainAll(java.util.Collection c)
retainAll
in interface java.util.Collection
retainAll
in interface java.util.List
c
- collection that defines which elements this set will retain.List.remove(Object)
, List.contains(Object)
public void clear()
clear
in interface java.util.Collection
clear
in interface java.util.List
public boolean equals(java.lang.Object o)
equals
in interface java.util.Collection
equals
in interface java.util.List
o
- the object to be compared for equality with this list.Object.equals(Object)
, Set.equals(Object)
, List.equals(Object)
public int hashCode()
hashCode = 1; Iterator i = list.iterator(); while (i.hasNext()) { Object obj = i.next(); hashCode = 31*hashCode + (obj==null ? 0 : obj.hashCode()); }This ensures that list1.equals(list2) implies that list1.hashCode()==list2.hashCode() for any two lists, list1 and list2, as required by the general contract of Object.hashCode.
hashCode
in interface java.util.Collection
hashCode
in interface java.util.List
Object.hashCode()
, Object.equals(Object)
, List.equals(Object)
public java.lang.Object get(int index)
get
in interface java.util.List
index
- index of element to return.public java.lang.Object set(int index, java.lang.Object element)
set
in interface java.util.List
index
- index of element to replace.element
- element to be stored at the specified position.public void add(int index, java.lang.Object element)
add
in interface java.util.List
index
- index at which the specified element is to be inserted.element
- element to be inserted.public java.lang.Object remove(int index)
remove
in interface java.util.List
index
- the index of the element to removed.public int indexOf(java.lang.Object o)
indexOf
in interface java.util.List
o
- element to search for.public int lastIndexOf(java.lang.Object o)
lastIndexOf
in interface java.util.List
o
- element to search for.public java.util.ListIterator listIterator()
listIterator
in interface java.util.List
public java.util.ListIterator listIterator(int index)
listIterator
in interface java.util.List
index
- index of first element to be returned from the list iterator (by a call to the next method).public java.util.List subList(int fromIndex, int toIndex)
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 passing 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 indexOf and lastIndexOf, and all of the algorithms in the Collections class can be applied to a subList.
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 this list, or otherwise perturb it in such a fashion that iterations in progress may yield incorrect results.)
subList
in interface java.util.List
fromIndex
- low endpoint (inclusive) of the subList.toIndex
- high endpoint (exclusive) of the subList.
|
Oracle® Coherence Java API Reference Release 3.7.1.0 E22843-01 |
|||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |