Groovy 2.2.0

groovy.lang
[Java] Interface Range

groovy.lang.Range
  java.lang.Iterable
      java.util.Collection
All Superinterfaces:
Iterable, Collection

public interface Range
extends List

A Range represents the list of all items obtained by starting from a from value and calling next() successively until you reach the to value. For a reverse range, the list is obtained by starting at the to value and successively calling previous() until the from value is reached.

Authors:
James Strachan
Version:
\$Revision\$


Method Summary
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.

Object getFrom()

The lower value in the range.

Object getTo()

The upper value in the range.

String inspect()

@return the verbose String representation of this Range as would be typed into a console to create the Range instance

boolean isReverse()

Indicates whether this is a reverse range which iterates backwards starting from the to value and ending on the from value

void step(int step, Closure closure)

Steps through the range, calling a closure for each number.

List step(int step)

Forms a list by stepping through the range by the indicated interval.

 
Methods inherited from interface List
add, add, remove, remove, get, equals, hashCode, indexOf, clear, contains, isEmpty, lastIndexOf, size, subList, toArray, toArray, addAll, addAll, iterator, set, retainAll, containsAll, listIterator, listIterator, removeAll
 
Methods inherited from class Object
wait, wait, wait, equals, toString, hashCode, getClass, notify, notifyAll
 

Method Detail

containsWithinBounds

public 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.
Parameters:
o - the object to check against the boundaries of the range
Returns:
true if the object is between the from and to values


getFrom

public Object getFrom()
The lower value in the range.
Returns:
the lower value in the range.


getTo

public Object getTo()
The upper value in the range.
Returns:
the upper value in the range


inspect

public String inspect()
Returns:
the verbose String representation of this Range as would be typed into a console to create the Range instance


isReverse

public boolean isReverse()
Indicates whether this is a reverse range which iterates backwards starting from the to value and ending on the from value
Returns:
true if this is a reverse range


step

public void step(int step, Closure closure)
Steps through the range, calling a closure for each number.
Parameters:
step - the amount by which to step. If negative, steps through the range backwards.
closure - the Closure to call


step

public List step(int step)
Forms a list by stepping through the range by the indicated interval.
Parameters:
step - the amount by which to step. If negative, steps through the range backwards.
Returns:
the list formed by stepping through the range by the indicated interval.


 

Copyright © 2003-2013 The Codehaus. All rights reserved.