public class ObjectRange extends AbstractList implements Range
Represents an inclusive list of objects from a value to a value using comparators.
Note: This class is similar to IntRange. If you make any changes to this class, you might consider making parallel changes to IntRange.
Constructor and description |
---|
ObjectRange
(Comparable from, Comparable to) Creates a new ObjectRange. |
ObjectRange
(Comparable smaller, Comparable larger, boolean reverse) Creates a new ObjectRange assumes smaller <= larger, else behavior is undefined. |
Type Params | Return Type | Name and description |
---|---|---|
|
protected void |
checkBoundaryCompatibility() throws IllegalArgumentException if to and from are incompatible, meaning they e.g. |
|
protected int |
compareTo(Comparable first, Comparable second) |
|
boolean |
contains(Object value) Iterates over all values and returns true if one value matches. |
|
boolean |
containsWithinBounds(Object value) Checks whether a value is between the from and to values of a Range |
|
protected Object |
decrement(Object value) Decrements by one |
|
boolean |
equals(Object that) |
|
boolean |
equals(ObjectRange that) Compares an ObjectRange to another ObjectRange. |
|
Comparable |
get(int index) |
|
Comparable |
getFrom() |
|
Comparable |
getTo() |
|
protected Object |
increment(Object value) Increments by one |
|
String |
inspect() |
|
boolean |
isReverse() |
|
Iterator<Comparable> |
iterator() {@inheritDoc} |
|
int |
size() |
|
void |
step(int step, Closure closure) |
|
List<Comparable> |
step(int step) |
|
List<Comparable> |
subList(int fromIndex, int toIndex) |
|
String |
toString() |
Methods inherited from class | Name |
---|---|
class AbstractList |
add, add, remove, get, equals, hashCode, indexOf, clear, lastIndexOf, subList, iterator, addAll, set, listIterator, listIterator, remove, toString, isEmpty, contains, size, toArray, toArray, addAll, containsAll, retainAll, removeAll, wait, wait, wait, getClass, notify, notifyAll, toArray, spliterator, stream, removeIf, parallelStream, forEach, replaceAll, sort |
Creates a new ObjectRange. Creates a reversed range if
from
< to
.
from
- the first value in the range.to
- the last value in the range.Creates a new ObjectRange assumes smaller <= larger, else behavior is undefined. Caution: Prefer the other constructor when in doubt.
Optimized Constructor avoiding initial computation of comparison.
throws IllegalArgumentException if to and from are incompatible, meaning they e.g. (likely) produce infinite sequences. Called at construction time, subclasses may override cautiously (using only members to and from).
Iterates over all values and returns true if one value matches.
Checks whether a value is between the from and to values of a Range
value
- the value of interestDecrements by one
value
- the value to decrementCompares an ObjectRange to another ObjectRange.
that
- the object to check equality withtrue
if the ranges are equalIncrements by one
value
- the value to increment{@inheritDoc}
Copyright © 2003-2020 The Apache Software Foundation. All rights reserved.