groovy.lang
Interface Range

All Superinterfaces:
java.util.Collection, java.lang.Iterable, java.util.List
All Known Implementing Classes:
EmptyRange, IntRange, ObjectRange

public interface Range
extends java.util.List

Represents the interface of a Range implementation which includes the from and to values.

Version:
$Revision: 6817 $
Author:
James Strachan

Method Summary
 boolean containsWithinBounds(java.lang.Object o)
          Indicates whether this is a reverse range which iterates backwards starting from the to value and ending on the from value
 java.lang.Comparable getFrom()
          Gets the lower value in the range.
 java.lang.Comparable getTo()
          Gets the lower value in the range.
 java.lang.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
 java.util.List 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.
 
Methods inherited from interface java.util.List
add, add, addAll, addAll, clear, contains, containsAll, equals, get, hashCode, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, retainAll, set, size, subList, toArray, toArray
 

Method Detail

getFrom

java.lang.Comparable getFrom()
Gets the lower value in the range.

Returns:
the lower value in the range.

getTo

java.lang.Comparable getTo()
Gets the lower value in the range.

Returns:
the upper value in the range

isReverse

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

containsWithinBounds

boolean containsWithinBounds(java.lang.Object o)
Indicates whether this is a reverse range which iterates backwards starting from the to value and ending on the from 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

step

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

java.util.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.

inspect

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

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