public class IntRange extends AbstractList<Integer> implements Range<Integer>
This class is a copy of ObjectRange optimized for int. If you make any
changes to this class, you might consider making parallel changes to ObjectRange.
Instances of this class may be either inclusive aware or non-inclusive aware. See the
relevant constructors for creating each type. Inclusive aware IntRange instances are
suitable for use with Groovy's range indexing - in particular if the from or to values
might be negative. This normally happens underneath the covers but is worth keeping
in mind if creating these ranges yourself explicitly.
modCount| Modifier | Constructor and Description |
|---|---|
|
IntRange(boolean inclusive,
int from,
int to)
Creates a new inclusive aware
IntRange. |
|
IntRange(int from,
int to)
Creates a new non-inclusive
IntRange. |
protected |
IntRange(int from,
int to,
boolean reverse)
Creates a new non-inclusive aware
IntRange. |
| Modifier and Type | Method and Description |
|---|---|
boolean |
contains(Object value) |
boolean |
containsAll(Collection other) |
boolean |
containsWithinBounds(Object o)
Indicates whether an object is greater than or equal to the
from
value for the range and less than or equal to the to value. |
boolean |
equals(IntRange that)
|
boolean |
equals(Object that)
Determines if this object is equal to another object.
|
Integer |
get(int index) |
Integer |
getFrom()
The lower value in the range.
|
int |
getFromInt()
Gets the 'from' value as a primitive integer.
|
Boolean |
getInclusive()
Returns the inclusive flag.
|
Integer |
getTo()
The upper value in the range.
|
int |
getToInt()
Gets the 'to' value as a primitive integer.
|
String |
inspect() |
boolean |
isReverse()
Indicates whether this is a reverse range which iterates backwards
starting from the to value and ending on the from value
|
Iterator<Integer> |
iterator() |
int |
size() |
List<Integer> |
step(int step)
Forms a list by stepping through the range by the indicated interval.
|
void |
step(int step,
Closure closure)
Steps through the range, calling a closure for each number.
|
List<Integer> |
subList(int fromIndex,
int toIndex) |
RangeInfo |
subListBorders(int size)
A method for determining from and to information when using this IntRange to index an aggregate object of the specified size.
|
String |
toString() |
add, add, addAll, clear, hashCode, indexOf, lastIndexOf, listIterator, listIterator, remove, removeRange, setaddAll, isEmpty, remove, removeAll, retainAll, toArray, toArraypublic IntRange(int from,
int to)
IntRange. If from is greater than
to, a reverse range is created with from and to swapped.from - the first number in the range.to - the last number in the range.IllegalArgumentException - if the range would contain more than Integer.MAX_VALUE values.protected IntRange(int from,
int to,
boolean reverse)
IntRange.from - the first value in the range.to - the last value in the range.reverse - true if the range should count from
to to from.IllegalArgumentException - if from is greater than to.public IntRange(boolean inclusive,
int from,
int to)
IntRange.from - the first value in the range.to - the last value in the range.inclusive - true if the to value is included in the range.public RangeInfo subListBorders(int size)
size - the size of the aggregate being indexedpublic boolean equals(Object that)
AbstractList.equals(Object) if that is anything
other than an IntRange.
It is not necessary to override hashCode, as
AbstractList.hashCode() provides a suitable hash code.
Note that equals is generally handled by DefaultGroovyMethods.equals(List,List)
instead of this method.
equals in interface Collection<Integer>equals in interface List<Integer>equals in class AbstractList<Integer>that - the object to comparetrue if the objects are equalpublic boolean equals(IntRange that)
that - the object to compare for equalitytrue if the ranges are equalpublic Integer getFrom()
public Integer getTo()
public Boolean getInclusive()
public int getFromInt()
public int getToInt()
public boolean isReverse()
public boolean containsWithinBounds(Object o)
Rangefrom
value for the range and less than or equal to the to value.containsWithinBounds in interface Range<Integer>o - the object to check against the boundaries of the rangetrue if the object is between the from and to valuespublic Integer get(int index)
public int size()
size in interface Collection<Integer>size in interface List<Integer>size in class AbstractCollection<Integer>public String toString()
toString in class AbstractCollection<Integer>public String inspect()
public boolean contains(Object value)
contains in interface Collection<Integer>contains in interface List<Integer>contains in class AbstractCollection<Integer>public boolean containsAll(Collection other)
containsAll in interface Collection<Integer>containsAll in interface List<Integer>containsAll in class AbstractCollection<Integer>public void step(int step,
Closure closure)