public class ListCursor<E> extends AbstractCursor<E>
List
. Optionally, the
Cursor may be limited to a specific range within the list.Constructor and Description |
---|
ListCursor()
Creates a new ListCursor without any elements.
|
ListCursor(Comparator<E> comparator)
Creates a new ListCursor without any elements.
|
ListCursor(Comparator<E> comparator,
int start,
List<E> list)
Creates a new ListCursor with a lower (inclusive) bound: the upper
(exclusive) bound is the size of the list.
|
ListCursor(Comparator<E> comparator,
int start,
List<E> list,
int end)
Creates a new ListCursor with lower (inclusive) and upper (exclusive)
bounds.
|
ListCursor(Comparator<E> comparator,
List<E> list)
Creates a new ListCursor without specific bounds: the bounds are
acquired from the size of the list.
|
ListCursor(Comparator<E> comparator,
List<E> list,
int end)
Creates a new ListCursor with a specific upper (exclusive) bound: the
lower (inclusive) bound defaults to 0.
|
ListCursor(int start,
List<E> list)
Creates a new ListCursor with a lower (inclusive) bound: the upper
(exclusive) bound is the size of the list.
|
ListCursor(int start,
List<E> list,
int end)
Creates a new ListCursor with lower (inclusive) and upper (exclusive)
bounds.
|
ListCursor(List<E> list)
Creates a new ListCursor without specific bounds: the bounds are
acquired from the size of the list.
|
ListCursor(List<E> list,
int end)
Creates a new ListCursor with a specific upper (exclusive) bound: the
lower (inclusive) bound defaults to 0.
|
Modifier and Type | Method and Description |
---|---|
void |
after(E element)
Prepares this Cursor, so a subsequent call to Cursor#previous() with a
true return value, will have positioned the Cursor on a dataSet element
equal to or less than the element argument but not greater.
|
void |
afterLast()
Positions this Cursor after the last element.
|
boolean |
available()
Determines whether or not a call to get() will succeed.
|
void |
before(E element)
Prepares this Cursor, so a subsequent call to Cursor#next() with a
true return value, will have positioned the Cursor on a dataSet
element equal to or less than the element argument but not greater.
|
void |
beforeFirst()
Positions this Cursor before the first element.
|
boolean |
first()
Positions this Cursor at the first element.
|
E |
get()
Gets the object at the current position.
|
boolean |
isAfterLast() |
boolean |
isBeforeFirst() |
boolean |
isElementReused()
Gets whether or not this Cursor will return the same element object
instance on get() operations for any position of this Cursor.
|
boolean |
isFirst() |
boolean |
isLast() |
boolean |
last()
Positions this Cursor at the last element.
|
boolean |
next()
Advances this Cursor to the next position.
|
boolean |
previous()
Advances this Cursor to the previous position.
|
checkNotClosed, close, close, isClosed, iterator, setClosureMonitor
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
forEach, spliterator
public ListCursor(Comparator<E> comparator, int start, List<E> list, int end)
comparator
- an optional comparator to use for orderingstart
- the lower bound indexlist
- the list this ListCursor operates onend
- the upper bound indexpublic ListCursor(int start, List<E> list, int end)
start
- the lower bound indexlist
- the list this ListCursor operates onend
- the upper bound indexpublic ListCursor(List<E> list, int end)
list
- the backing for this ListCursorend
- the upper bound index representing the position after the
last elementpublic ListCursor(Comparator<E> comparator, List<E> list, int end)
comparator
- The comparator to use for the list
- the backing for this ListCursorend
- the upper bound index representing the position after the
last elementpublic ListCursor(int start, List<E> list)
start
- the lower (inclusive) bound index: the position of the
first entrylist
- the backing for this ListCursorpublic ListCursor(Comparator<E> comparator, int start, List<E> list)
comparator
- The comparator to use for the start
- the lower (inclusive) bound index: the position of the
first entrylist
- the backing for this ListCursorpublic ListCursor(List<E> list)
list
- the backing for this ListCursorpublic ListCursor(Comparator<E> comparator, List<E> list)
comparator
- The comparator to use for the list
- the backing for this ListCursorpublic ListCursor()
public ListCursor(Comparator<E> comparator)
comparator
- The comparator to use for the public boolean available()
public void before(E element) throws Exception
Cursor
element
- the element to be positioned beforeIllegalStateException
- if the underlying list is not sorted
and/or a comparator is not provided.Exception
- with problems accessing the underlying btreeUnsupportedOperationException
- if this method is not supportedpublic void after(E element) throws Exception
element
- the element to be positioned afterException
- if there are problems positioning this cursor or if
this Cursor is closedUnsupportedOperationException
- if this method is not supportedpublic void beforeFirst() throws Exception
Exception
- if there are problems positioning this cursor or if
this Cursor is closedUnsupportedOperationException
- if this method is not supportedpublic void afterLast() throws Exception
Exception
- if there are problems positioning this Cursor or if
this Cursor is closedUnsupportedOperationException
- if this method is not supportedpublic boolean first() throws Exception
Exception
- if there are problems positioning this Cursor or if
this Cursor is closedUnsupportedOperationException
- if this method is not supportedpublic boolean last() throws Exception
Exception
- if there are problems positioning this Cursor or if
this Cursor is closedUnsupportedOperationException
- if this method is not supportedpublic boolean previous() throws Exception
Exception
- if there are problems advancing to the next positionUnsupportedOperationException
- if this method is not supportedpublic boolean next() throws Exception
Exception
- if there are problems advancing to this Cursor to
the next position, or if this Cursor is closedUnsupportedOperationException
- if this method is not supportedpublic E get() throws Exception
Exception
- if the object at this Cursor's current position
cannot be retrieved, or if this Cursor is closedpublic boolean isElementReused()
Copyright © 2003–2016 The Apache Software Foundation. All rights reserved.