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, set
addAll, isEmpty, remove, removeAll, retainAll, toArray, toArray
public 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)
Range
from
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)